Telegram ↔ tmux/herdr bridge for Claude Code, Codex CLI, and Gemini CLI. Monitor output, respond to prompts, manage parallel sessions. Control AI coding agents from your phone. - alexei-led/ccgram
No reviews yetBe the first to leave a review for ccgram
Maker
📌
ccgram is a self-hosted Telegram bot that bridges your phone to AI coding agents
running on your own machine. Each Telegram Forum topic maps 1:1 to a terminal
multiplexer window running Claude Code, Codex, Gemini, Pi, or a plain shell
session. The agent process stays in your local terminal — no cloud, no isolated
API session, no vendor SDK. Walk away, keep monitoring from Telegram, come back
and attach for full scrollback.
v4.0.0 adds herdr as a second supported multiplexer alongside tmux. herdr is a
modern terminal multiplexer with a workspace/tab model and native agent-status
support. Set CCGRAM_MULTIPLEXER=herdr — everything else works identically.
herdr-specific additions: workspace ▸ tab topic labels, workspace picker in /new,
native agent detection (no terminal scraping), session re-resolution after herdr
restarts, protocol version pinning.
Install: uv tool install ccgram