Code anywhere, anytime

Approve code, review PRs, and control AI agents — right from your phone.

Get Started Star on GitHub

$▎

How it works

Two-way bridge between terminal and phone

Discord

Slack

Zalo soon

ccpoke

Claude Code

Cursor CLI

Gemini CLI

Antigravity soon

Codex CLI

OpenCode

Copilot soon

Features

More than notifications

Push notification

AI agent done → notification pushed instantly. No polling, no delay.

Two-way interaction

Chat with your AI agent from Telegram. View active sessions, send prompts, answer questions — all without touching your laptop.

Multi-session

Manage multiple AI agent sessions simultaneously — switch between sessions, parallel monitoring, per-session context.

Setup

2 steps, 30 seconds

Node.js ≥ 20 required.

Create a bot token

Telegram: open @BotFather → /newbot → copy token.

Discord: Developer Portal → New Application → Bot → copy token.

Slack: Slack API → Create New App → From scratch → name your app & pick workspace → OAuth & Permissions → add chat:write scope → scroll up to OAuth Tokens → generate and copy Bot User OAuth Token.

Run one command

$ npx -y ccpoke

no config found — starting setup wizard...
┌  🤖 ccpoke setup
│
◇  Language
│  English
│
◇  Chat platform
│  Telegram
│
◇  Bot Token
│  ****:ABC-xxx
│
◇  ✓ Bot: @your_bot
│
◇  Scan QR or open link to connect:
│  https://t.me/your_bot?start=setup
│
◆  ✓ Connected!
│
◇  Select AI agents (space to toggle)
│  Claude Code, Cursor CLI
│
◆  Config saved · Hooks installed
│
└  🎉 Setup complete!

ccpoke: hook server listening on localhost:9377
ccpoke: telegram bot started

The setup wizard handles everything — hooks, bot connection, agent selection. For daily use, install globally: npm i -g ccpoke.

Roadmap

Long-term roadmap

Multi-platform — Telegram, Discord, and Slack supported. More platforms coming.

Phase 1 · Complete

Notification bridge

Push notification when your AI agent completes — git diff and full response viewer via Telegram Mini App. Supports Claude Code and Cursor CLI on macOS, Linux, and Windows.

Claude Code Codex CLI Cursor CLI macOS · Linux · Windows Stop hook Git diff Mini App viewer i18n (EN/VI/ZH) CLI (setup/update/uninstall) QR code setup

Phase 2 · Complete

Two-way chat

Chat with Claude Code from Telegram — view sessions, send prompts, answer simple questions remotely. Single panel, macOS and Linux only.

Send prompt → Claude Code Session list Answer questions (single/multi-select) Idle prompt forwarding tmux send-keys macOS · Linux

Phase 3 · Complete

Smart reply

Handle complex AskUser interactions — elicitation forms, multi-select with descriptions, and structured input — all from your phone.

Elicitation forms Multi-select + descriptions Structured input Rich chat UI Permission approve/deny

Phase 4 · Complete

Multi-session

Manage multiple Claude Code panels simultaneously — switch between sessions, parallel monitoring, and per-session context.

Multiple panels Session switching Parallel monitoring Per-session context

Phase 5 · In development

Terminal control

View live terminal output, capture screenshots, browse files, and run commands — all from Telegram.

Screenshot capture Live output stream File browser Remote command execution

Phase 6

Ecosystem

Plugin system, team collaboration, web dashboard with usage analytics, and more platform integrations.

Plugin system Team collaboration Web dashboard Usage analytics More platforms