Skip to content

Commit a1b0cbc

Browse files
AliceLJYclaude
andcommitted
docs: restructure both READMEs for marketing + technical quality
- Reorder "What This Unlocks": Parallel → Phone-First → Media → Multi-Agent → War Room → Always-On (progressive complexity) - Sync CN structure to match EN flow: features → quick start → commands → comparison - Add version + GitHub stars badges - Add Prerequisites section (Bun, bot token, backend CLI) - Fix version v2.2 → v3.0 in comparison tables - Add CN Ecosystem section + Multi-Instance Deployment - Move OpenClaw migration to collapsible in CN (matches EN) - Add War Room demo code block + comparison quote to CN header Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 62addef commit a1b0cbc

2 files changed

Lines changed: 211 additions & 112 deletions

File tree

README.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,10 @@
99
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.
1010

1111
[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
12+
[![Version](https://img.shields.io/badge/version-3.0.0-green.svg)](https://github.com/AliceLJY/telegram-ai-bridge/releases)
1213
[![Bun](https://img.shields.io/badge/Runtime-Bun-f9f1e1?logo=bun)](https://bun.sh)
1314
[![Telegram](https://img.shields.io/badge/Interface-Telegram-26A5E4?logo=telegram)](https://telegram.org/)
15+
[![GitHub stars](https://img.shields.io/github/stars/AliceLJY/telegram-ai-bridge)](https://github.com/AliceLJY/telegram-ai-bridge)
1416

1517
**English** | [简体中文](README_CN.md)
1618

@@ -42,14 +44,6 @@ Delta: [reads full context, commits]
4244

4345
## What This Unlocks
4446

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-
5347
### Parallel Sessions — Desktop Power, Phone Form Factor
5448

5549
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
9488

9589
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.
9690

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+
9799
### Always-On, Self-Hosted
98100

99101
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
104106

105107
## Quick Start
106108

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).
110+
107111
```bash
108112
git clone https://github.com/AliceLJY/telegram-ai-bridge.git
109113
cd telegram-ai-bridge
@@ -192,7 +196,7 @@ Claude Code now ships [Remote Control](https://code.claude.com/docs/en/remote-co
192196
| Shared context backend | N/A | N/A | N/A | SQLite / JSON / Redis (pluggable) |
193197
| Task audit trail | &mdash; | &mdash; | &mdash; | SQLite: status, cost, duration, approval log |
194198
| Loop guard for bot-to-bot | N/A | N/A | N/A | 5-layer: generation + cooldown + rate + dedup + AI |
195-
| Stable release | Yes | Research preview | Yes | Yes (v2.2) |
199+
| Stable release | Yes | Research preview | Yes | Yes (v3.0) |
196200

197201
**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.**
198202

0 commit comments

Comments
 (0)