Telegram Usage
Everything you'll see and do on Telegram after setting up ccpoke.
Bot Commands
Three commands available after setup:
| Command | Description |
|---|---|
| /start | Connect bot to your chat. Run once during setup. |
| /sessions | View all running AI agent sessions. Select one to chat or close. |
| /projects | View project list. Select a project to start a new agent session. |
Notifications
When an AI agent completes a task (stop hook fires)
You receive a push notification with: project name, agent type, task summary, model name. Two buttons: "View Details" opens the Mini App with the full response, "Chat" lets you send a follow-up prompt.
📦 my-app 🐾 Claude Code Added dark mode toggle to settings page with system preference detection. 🤖 Opus 4.6 [View Details] [Chat]
On Telegram iOS, if you tap Chat then close the app without replying, reopening may show a stale reply draft. This is a Telegram client behavior — just tap ✕ to dismiss it.
Two-way Chat
Tap "Chat" on a notification or select a session from /sessions
You must tap the "Chat" button to start — this tells ccpoke which agent session to deliver your message to. Two entry points: (1) the Chat button on a task notification (2) /sessions → pick a session → Chat After tapping, Telegram opens a reply box. Type your prompt, ccpoke injects it into the target agent via tmux send-keys.
via /sessions: Active sessions 🟢 my-app · opus-4.6 🟢 gia-pha → Select "gia-pha" gia-pha [💬 Chat] [🗑 Close] → Tap Chat 💬 gia-pha Type your message below ↓ > Summarize recent changes ✓ Sent to session
Requires tmux (macOS / Linux). Windows is not yet supported for two-way chat.
Permission Handling
When an agent needs permission (file write, bash command, etc.)
The agent pauses and sends a notification with the tool name and summary. You tap Allow to approve or Deny to reject. ccpoke injects "y" or "n" into the agent. Expires after 10 minutes.
🔐 Permission Request Tool: bash Command: rm -rf node_modules && npm install [✅ Allow] [❌ Deny]
Answering Questions
When an agent uses AskUserQuestion tool
Two modes: (1) Single/multi-select — inline buttons appear, pick one or toggle multiple + Confirm. (2) Open-ended — a text reply box opens so you can type a free-form answer.
Question 1/1 [Debug] Which testing framework should we use for this project? 1. Jest — Industry standard with widely supported ecosystem and mature tooling 2. Vitest — Fast, Vite-native unit test runner with HMR 3. Mocha — Flexible and mature with extensive plugin support Tap to choose [Jest] [Vitest] [Mocha] [Other]