raysonmeng/agent-bridge
A local bridge for bidirectional collaboration between Claude Code and Codex. 连接 Claude Code 与 Codex 的本地实时协作桥接工具。
288 ★47 forksTypeScriptUpdated 1d ago
What you need to know
A local bridge for bidirectional real-time communication between Claude Code and Codex inside the same working session, enabling cross-review, task splits, and quota relay for overnight runs without copy-paste.
Install
curl -fsSL https://bun.sh/install | bash (Bun v1.3.11+ required as runtime) npm install -g @anthropic-ai/claude-code (v2.1.80+) npm install -g @openai/codex npm install -g @raysonmeng/agentbridge && abg init
Usage
- •Start Claude Code with the push channel enabled: abg claude (launches with --dangerously-skip-permissions by default; use --safe to prompt).
- •In another terminal connect Codex TUI: abg codex (runs with --yolo by default; bare command auto-resumes the last thread, --new for fresh).
- •Ask Claude something like "Propose a task split with Codex for <task>, then have Codex implement while you review."
- •Operate the pair: abg resume, abg pairs, abg doctor, abg budget, abg logs, abg kill.
Key features
- ✓Bidirectional Claude <-> Codex messaging in one session; Codex output pushed to Claude as channel notifications, Claude replies injected into the Codex thread as turn/start.
- ✓Context filtering: only agentMessage crossings, three-tier marker routing ([IMPORTANT] / [STATUS] / [FYI]) defined once in AGENTS.md, so contexts grow with real exchanges, not raw activity.
- ✓Turn coordination with busy-guard, inactivity watchdog, and loop prevention via per-message source field.
- ✓Budget coordination and auto-resume via companion agent-quota-guard: clean stop at turn boundary near quota hard-line, checkpoint.md, and automatic resume when the window refreshes.
- ✓Multiple pairs per machine (one per project directory, ports 4500+10 strides); persistent background daemon survives Claude Code restarts.
Best for
Developers who run Claude Code and Codex side by side and want the two agents to review each other and pick up tasks across subscription-quota windows automatically.
Caveats
- ⚠Windows is not an officially supported platform.
- ⚠abg claude and abg codex launch with max-permission flags (--dangerously-skip-permissions / --yolo) by default - only use in a workspace you trust.
- ⚠Only forwards agentMessage items, not intermediate commandExecution/fileChange events; single Codex thread per pair; single Claude foreground connection per pair.
- ⚠Budget coordination is experimental/opt-in and best-effort on the Claude side.
Platforms: macOS · LinuxClients: Claude Code · Codex CLI
Documentation ↗Reviewed 2026-08-07
Topics
agent-collaborationclaude-codeclicodexdeveloper-toolslocal-firstmcpmodel-context-protocolmulti-agent
- Stars
- 288★
- Forks
- 47
- Language
- TypeScript
- License
- MIT
- Created
- 2026-03-20
- Last push
- 2026-08-05