CLI Reference

$ ccpoke

Start the ccpoke server. On first run (no config found), the setup wizard launches automatically — installs hooks, connects Telegram, everything in one go. On subsequent runs, it loads your config and starts the hook server + Telegram bot.

Every time you start a work session

$ ccpoke

ccpoke: hook server listening on localhost:9377
ccpoke: telegram bot started
ccpoke: watching 2 agents (claude-code, cursor-cli)
ccpoke: 1 project registered

$ ccpoke setup

Re-run the setup wizard to change settings: language, bot token, agent selection, projects. Use this when you want to reconfigure after initial setup.

When you want to change settings

$ ccpoke setup

┌  🤖 ccpoke setup
│
◇  Language
│  English
│
◇  Telegram Bot Token
│  ****:ABC-xxx
│
◇  ✓ Bot: @your_bot
│
◆  Config saved

$ ccpoke project

Manage your project list: add new projects, edit names/paths, or remove entries. Projects appear in Telegram's /projects command.

When working with multiple codebases

$ ccpoke project

Projects:
  1. my-app     ~/code/my-app
  2. api-server ~/code/api

◇  Action
│  Add new project

$ ccpoke channel

Switch the active notification channel (Telegram, Discord, or Slack). If the target channel is not yet configured, the wizard will guide you through setup.

When you want to switch notification platform

$ ccpoke channel

┌  📡 Channel
│
◇  Current: Telegram
│
◇  Select channel
│  Discord
│
◆  Switched to Discord

$ ccpoke update

Check for the latest version and update. Also shows your current version. Automatically re-installs hooks for all configured agents after updating. Note: use this command to check version — --version flag is not supported.

When a new version is available

$ ccpoke update

✓ Current: 1.6.17
✓ Latest:  1.6.18
✓ Updated to 1.6.18
✓ Hooks re-installed

$ ccpoke uninstall

Remove all hooks, shell completions, and optionally your config. Clean uninstall — no traces left.

When you no longer need ccpoke

$ ccpoke uninstall

✓ Removed claude-code hook
✓ Removed cursor-cli hook
✓ Removed shell completions
◇  Delete config? (y/N)
│  n
✓ Uninstall complete

$ ccpoke help

Show all available commands and basic usage information.

Anytime you need a quick reference

$ ccpoke help

Usage: ccpoke [command]

Commands:
  (default)   Start the bot
  setup       Configure bot + agents
  project     Manage projects
  update      Update to latest version
  uninstall   Remove hooks and config
  help        Show this help