You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+13-9Lines changed: 13 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,8 +9,10 @@
9
9
A self-hosted Telegram bridge that runs **actual Claude Code** — not an API wrapper — with full session management, multi-backend support (Claude + Codex + Gemini), and agent-to-agent collaboration.
@@ -42,14 +44,6 @@ Delta: [reads full context, commits]
42
44
43
45
## What This Unlocks
44
46
45
-
### War Room — Multi-CC Command Center
46
-
47
-
Put all 4 CC bots in one Telegram group. Each bot stays silent until @mentioned — no crosstalk, no chaos. But every bot can read what the others said via shared context (Redis-backed). You orchestrate — they execute.
48
-
49
-
Two collaboration modes in one project:
50
-
-**A2A mode** (CC + Codex group): bots auto-respond to each other with loop guards — for brainstorming and debate
51
-
-**War Room mode** (multi-CC group): @mention only — for coordinated parallel execution
52
-
53
47
### Parallel Sessions — Desktop Power, Phone Form Factor
54
48
55
49
On your desktop you run 4-5 Claude Code windows simultaneously. Now do the same from your phone:
@@ -94,6 +88,14 @@ The bridge captures images from SDK tool results (base64 data from Read/peekaboo
94
88
95
89
Put `@claude-bot` and `@codex-bot` in the same Telegram group. Ask Claude to review code — Codex reads the reply via shared context and offers its own take automatically. Built-in loop guards and circuit breakers prevent runaway bot-to-bot conversations. For DM cross-checking, bots communicate directly via MCP/CLI — no relay needed.
96
90
91
+
### War Room — Multi-CC Command Center
92
+
93
+
Put all 4 CC bots in one Telegram group. Each bot stays silent until @mentioned — no crosstalk, no chaos. But every bot can read what the others said via shared context (Redis-backed). You orchestrate — they execute.
94
+
95
+
Two collaboration modes in one project:
96
+
-**A2A mode** (CC + Codex group): bots auto-respond to each other with loop guards — for brainstorming and debate
97
+
-**War Room mode** (multi-CC group): @mention only — for coordinated parallel execution
98
+
97
99
### Always-On, Self-Hosted
98
100
99
101
macOS LaunchAgent or Docker keeps the bridge running in the background. Sessions persist in SQLite across restarts and reboots — pick up where you left off after a reboot, a network drop, or a flight. Code and credentials never leave your machine. Owner-only access by default.
@@ -104,6 +106,8 @@ macOS LaunchAgent or Docker keeps the bridge running in the background. Sessions
104
106
105
107
## Quick Start
106
108
109
+
**Prerequisites:**[Bun](https://bun.sh) runtime, a Telegram bot token (from [@BotFather](https://t.me/BotFather)), and at least one backend CLI: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://openai.com/index/codex/), or [Gemini CLI](https://ai.google.dev/gemini-api/docs/ai-studio-quickstart).
**What official tools do better:** Remote Control streams full terminal output. Channels relay tool-approval dialogs natively. Claude Code on the web provides cloud compute without local setup. This project optimizes for a different job: **persistent, multi-agent session management entirely from Telegram.**
0 commit comments