ccgram

Telegram ↔ tmux/herdr/agterm bridge for Claude Code, Codex CLI, and Pi Agent. Monitor output, respond to prompts, manage parallel sessions. Control AI coding a

What is ccgram?

Telegram ↔ tmux/herdr/agterm bridge for Claude Code, Codex CLI, and Pi Agent. Monitor output, respond to prompts, manage parallel sessions. Control AI coding agents from your phone.

Overview of ccgram

What it is

CCGram is a Telegram ↔ tmux/herdr/agterm bridge for Claude Code, Codex CLI, and Pi Agent. It monitors output, responds to prompts, and manages parallel sessions. It sits on top of a terminal multiplexer (tmux, herdr, or agterm), not any agent SDK. The agent process stays in the terminal session, which remains the source of truth.

Key features

  • Bind agents to topics — one agent per group or private-chat topic; create via directory browser - Auto-detect providers — Supports Claude Code, Codex, Gemini, Pi, and Shell simultaneously - Monitor live — Terminal screenshots on demand or auto-refresh every 5 seconds - Topic-aware command panels — Four safe General controls; session-specific CCGram actions and original agent command names in each topic - Send commands — Slash commands, voice messages (transcribed via Whisper), or raw shell input - Run multiple agents in parallel — each topic independent; run different agents at once - Recover gracefully — Resume, continue, or start fresh if a session crashes

Use cases

  • Walk away from a desktop mid-session and keep monitoring and responding from Telegram - Switch from phone back to desktop and attach to the terminal with full scrollback - Run multiple AI coding agents (Claude, Codex, Gemini, Pi) in parallel, each in its own topic - Send workspace files to Telegram via /send - Answer numbered and yes/no agent prompts with one tap

Getting started

Install: bash uv tool install ccgram # recommended # or: pipx install ccgram | brew install alexei-led/tap/ccgram Run: bash ccgram See the repository README for Telegram bot setup and environment configuration.

License and pricing

MIT license. Open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/alexei-ledccgram.svg)](https://yunodb.com/tools/alexei-ledccgram?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/alexei-ledccgram?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/alexei-ledccgram.svg" alt="Featured on YunoDB" height="20"></a>