Auto-discovered marketplace from imskinner/cc-afk
npx claudepluginhub imskinner/cc-afkBridge Claude Code with Telegram — get permissions, notifications, and send remote prompts from your phone while AFK
Control Claude Code remotely via Telegram while you're away from your desk.
cc-afk is a Claude Code plugin that bridges your CLI session with a Telegram bot. Activate it with /cc-afk:afk, walk away, and manage everything — permissions, tool results, notifications — from your phone.
┌──────────────────┐ hooks (stdin JSON) ┌──────────────────┐
│ Claude Code │ ──────────────────────────► │ Hook Handler │
│ (CLI session) │ │ (short-lived) │
└──────────────────┘ └────────┬─────────┘
│ HTTP localhost
▼
┌──────────────────┐ Telegram Bot API
│ Bridge Service │ ◄──────────────────► 📱 You
│ (persistent) │ (long-polling)
└──────────────────┘
/cc-afk:afk) — starts/stops the bridge and runs setup from inside a Claude Code sessionInside a Claude Code session:
/plugin marketplace add imskinner/cc-afk
/plugin install cc-afk@cc-afk
git clone https://github.com/imskinner/cc-afk.git
cd cc-afk
npm install
Then launch Claude Code with the plugin loaded:
claude --plugin-dir /path/to/cc-afk
No build step needed — bundled dist/ files are committed to the repo.
/newbot and follow the prompts to create your bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)Inside a Claude Code session with the plugin installed:
/cc-afk:afk setup
Claude will walk you through:
/cc-afk:afk
The bridge starts, the Telegram bot connects, and you'll see "AFK mode activated" in your chat. Walk away.
/cc-afk:afk refactor the auth module
Starts the bridge and begins working on the task immediately. Permission requests and tool results are forwarded to Telegram while Claude works. When the task is done, Claude waits for follow-up messages from Telegram.
If Claude is already working on something and you need to leave:
/cc-afk:afk continue what you were doingSince it's the same session, Claude has full context of everything before the interrupt.
/status — check bridge status and pending permissions/cancel — cancel a running remote prompt/stop — deactivate AFK mode and shut down the bridgeFrom inside Claude Code:
/cc-afk:afk off
From Telegram:
/stop
Config is stored at $CLAUDE_PLUGIN_DATA/config.json (or ~/.cc-afk/config.json as fallback):
{
"telegram": {
"botToken": "your-bot-token",
"chatId": 123456789
},
"bridge": {
"port": 19211,
"permissionTimeoutSeconds": 300
}
}
Environment variables also work:
| Variable | Purpose |
|---|---|
TELEGRAM_BOT_TOKEN | Bot token (overrides config file) |
TELEGRAM_CHAT_ID | Chat ID (overrides config file) |