<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> CCBot bridges Telegram with terminal-based Claude Code sessions, enabling remote monitoring and interaction with AI coding tasks. It targets users needing to manage long-running AI development processes away from their workstation, offering seamless continuity between desktop and mobile. The core benefit is maintaining visibility and control over AI sessions without interrupting execution.

How It Works

CCBot interfaces directly with tmux sessions, rather than wrapping the Claude Code SDK. It monitors tmux output and injects keystrokes, treating the terminal as the source of truth. This allows users to switch from their phone back to their desktop session, retaining full context and scrollback, as the AI process remains uninterrupted in its tmux window. Each Telegram topic maps to a distinct tmux window, facilitating parallel management of multiple AI projects.

Quick Start & Requirements

Installation is recommended via uv tool install git+https://github.com/six-ddc/ccmux.git or pipx install git+https://github.com/six-ddc/ccmux.git. Prerequisites include tmux installed and in PATH, and the claude CLI tool. Users must set up a Telegram bot via @BotFather, enable Threaded Mode, and configure environment variables (TELEGRAM_BOT_TOKEN, ALLOWED_USERS) in ~/.ccbot/.env. Optional: OpenAI API key for voice transcription. Hook setup via ccbot hook --install is recommended for automatic session tracking.

Highlighted Details

• Topic-based sessions: Each Telegram topic corresponds to one tmux window and Claude session.
• Real-time notifications for assistant responses, thinking, tool use, and local command output.
• Interactive UI for navigating prompts and permissions via inline keyboards.
• Voice messages are transcribed via OpenAI and forwarded as text.
• Direct forwarding of Claude Code commands (e.g., /clear, /compact) and any unrecognized commands.
• Message history browsing with pagination and terminal screenshot capture.

Maintenance & Community

The project encourages contributions via Claude Code collaboration. Specific details on active maintainers, community channels (like Discord/Slack), or a public roadmap are not detailed in the provided README.

Licensing & Compatibility

The README does not explicitly state the project's license. This omission requires further investigation for commercial use or integration into closed-source projects.

Limitations & Caveats

CCBot requires a functional tmux environment and the claude CLI. Voice transcription relies on an external OpenAI API key. The absence of explicit licensing information is a significant caveat for adoption.