agent-bridge: Connect Claude Code and Codex for Collaboration

Overview

AgentBridge is a local bridge that lets Claude Code and Codex communicate as persistent peers during a coding session. It relays selected agent messages and replies between Claude’s MCP channel and Codex’s app-server, so developers do not have to manually shuttle text between terminals.

Use it when you want two coding agents to divide work, review each other’s changes, or hand off tasks while keeping their individual context windows separate. It is a focused integration for these two tools, not a general-purpose agent orchestration platform.

Key Features

• Bidirectional message relay between Claude Code and Codex during a shared workflow.
• Cross-review support, including sending review feedback into the other agent’s active thread.
• Filters Codex output to forward meaningful agent messages rather than tool activity or full transcripts.
• Coordinates turns with a busy guard and an inactivity watchdog.
• Runs a persistent local daemon that can reconnect after Claude Code restarts.
• Supports multiple project pairs on one machine, with commands to inspect and manage them.
• Offers optional quota snapshots and task resume coordination through the companion agent-quota-guard tool.

Use Cases

• A developer using both Claude Code and Codex wants one agent to review the other’s implementation without copying diffs between sessions.
• A small team or solo developer wants agents to propose and negotiate a task split before working in parallel.
• A long-running coding task needs to hand off between agents when one subscription quota window runs dry.
• A developer wants to experiment with human-steered, peer-to-peer agent collaboration on a local project.

Getting Started

Install Bun and the CLI, then initialize the project and launch each agent:

npm install -g @raysonmeng/agentbridge
abg init
abg claude
# In another terminal, in the same project:
abg codex

See the README for prerequisites, safe-mode options, configuration, and troubleshooting. The project website includes an animated session replay.

Alternatives

• synara: Synara coordinates coding-agent sessions in a desktop workspace with project files, terminals, previews, and Git review rather than relaying messages between Claude Code and Codex.
• deliberation: Deliberation routes plans and code questions to external models for second opinions or consensus, rather than handing tasks between Claude Code and Codex.

Considerations

• Bun is required to run the daemon and plugin server; Node.js alone is not sufficient.
• The default launch commands enable broad permissions for unattended work. Use --safe or AGENTBRIDGE_SAFE=1 if you want normal permission prompts, and only run the defaults in a workspace you trust.
• The bridge is limited to Claude Code and Codex, with one Codex thread and one foreground Claude connection per pair.
• Cross-network rooms and quota-based automatic resume are described as experimental or preview features.
• Windows is not officially supported. The project also states that it is not a hardened security boundary between untrusted tools.