What is ccpoke?

ccpoke is a two-way bridge between your AI coding agents and your phone. When your agent finishes a task, you get a push notification on Telegram, Discord, or Slack. Need to send a prompt, answer a question, or approve a permission? Do it right from your phone.

It works with Claude Code, Codex CLI, Cursor CLI, Gemini CLI, OpenCode and more. Supports Telegram, Discord, and Slack. Open-source, self-hosted, MIT licensed.

  AI Agent (Claude Code, Codex CLI...)
       │
       ▼
   ccpoke (hook server)
       │
       ├─► Telegram Bot  → 📱
       ├─► Discord Bot   → 💬
       └─► Slack Bot     → 📢

Getting Started

You need Node.js ≥ 20 and a bot token (Telegram, Discord, or Slack) to get started.

1

Create a Bot Token

Open @BotFather on Telegram → /newbot → save the token.

2

Run the setup

npx -y ccpoke runs ccpoke without installing — great for trying it out. For regular use, install globally with npm i -g ccpoke (recommended).

# Quick try (no install):
$ npx -y ccpoke

# Recommended (install globally):
$ npm i -g ccpoke
$ ccpoke
3

Connect your phone

Scan the QR code or click the link shown in terminal. Setup is automatic — no manual User ID needed.