agent-bridge

AgentBridge 是一个本地开发工具，用于在同一工作会话内连接 Claude Code 与 Codex，实现双向实时协作。它并非托管服务，也不是通用编排框架，而是面向人机协同的多智能体实验性设置。

用途

• 交叉审查：Codex 实现代码，Claude 在同一会话内审查 diff，并把修改请求直接推回 Codex 的线程，两个提供方互相检查，无需复制粘贴。
• 单提示分工：要求任一智能体与另一方提议分工，二者在写代码前协商各自负责的部分，由用户进行方向把控。
• 额度接力：当一方订阅窗口耗尽时，在回合边界干净停止并把手头任务移交给另一方，使长任务持续运行而非在限额处失败。

主要能力

• 双向消息传递：守护进程拦截 Codex 输出并以频道通知推送给 Claude；Claude 通过 reply MCP 工具回复，桥接器以 turn/start 形式把回复注入 Codex 线程。
• 推送投递与回退：消息以频道通知到达，推送失败时回退到内存队列，由 get_messages 取出；通过每条消息的 source 字段防止循环。
• 回合协调：busy-guard 在 Codex 回合活跃时拒绝回复；每回合无活动看门狗防止丢失的 turn/completed 永久锁死注入；折叠嘈杂的中间事件，只让有意义的 agentMessage 到达 Claude。
• 多对并行：每个项目目录一对 Claude+Codex，端口从 4500 起以 +10 步长分配；成对感知命令支持 claude、codex、resume、kill、doctor、budget 配合 --pair 使用。
• 生命周期弹性：持久后台守护进程可在 Claude Code 重启后存活并自动重连（带退避）；支持孤儿进程清理、abg doctor 只读诊断、abg pairs prune 回收滞留状态。
• 线程自动恢复：直接执行 abg codex 可恢复该对上一次的 Codex 线程；abg resume 打印或执行双方的恢复命令。
• 预算协调与自动恢复：借助配套工具 agent-quota-guard 实现跨订阅额度窗口的慢速线与自动续跑。

上下文处理 桥接只传递消息而非上下文：每个智能体保有各自的上下文窗口，桥接器不会把一个智能体的完整记录复制给另一个。只有 agentMessage 会跨界；commandExecution、fileChange 与推理增量不会到达另一方，完整回滚记录也不传递。默认过滤模式下采用三级标记路由：[IMPORTANT] 立即转发，[STATUS] 缓冲并批量汇总（默认 3 条更新或 15 秒），[FYI] 丢弃。标记规则仅写在项目的 AGENTS.md 中（由 abg init 写入），在智能体启动时加载。把 AGENTBRIDGE_FILTER_MODE 设为 full（或相应配置）可获得未过滤流。

使用方式 需要 Bun 作为 AgentBridge 守护进程和插件服务器的运行时，仅有 Node.js 不够；若 abg 安装后无法运行，先安装 Bun。基本流程为安装后运行 abg init 初始化，再分别启动 abg claude 与 abg codex（abg 是 agentbridge 的短别名，两者等价）。 abg claude 默认带 --dangerously-skip-permissions 启动，abg codex 默认带 --yolo 启动，意味着两者无需提示即可运行命令和编辑文件，仅应在可信工作区使用；如需正常权限提示可加 --safe，或设置 AGENTBRIDGE_SAFE=1，传入自定义权限标志时这些默认值也会自动抑制。abg claude 拥有 --channels、--dangerously-load-development-channels 标志；abg codex 拥有 --remote、--enable tui_app_server 标志；手动传入这些专属标志会报错并提示直接使用原生命令。 架构上由两个进程组成：bridge.ts 是 Claude Code 通过 AgentBridge 插件启动的前台 MCP 客户端，Claude Code 关闭时退出；daemon.ts 是持久本地后台进程，拥有 Codex app-server 代理和桥接状态的唯一事实来源，在 Claude Code 重启后存活，bridge.ts 以指数退避重连。 运行 agentbridge init 会在项目根目录创建 .agentbridge/ 目录，配置由 CLI 与守护进程在启动时加载；重复运行 init 是幂等的，不会覆盖已有文件。守护进程把运行时状态存于平台感知目录，包括 daemon.pid、status.json、agentbridge.log、killed（哨兵）、startup.lock。

适用场景

• 需要两个提供方交叉验证代码的中小型开发任务。
• 希望由单个提示触发智能体自行协商分工的协作开发。
• 需要长时间运行、跨订阅额度窗口持续推进的自动化任务。
• 多项目目录并行运行多对智能体的本地开发环境。

限制

• 仅转发 agentMessage，不转发中间 commandExecution、fileChange 等事件。
• 每对仅单个 Codex 线程，尚不支持对内的多会话。
• 每对仅单个 Claude 前台连接，新 Claude 会话会替换前一个。
• 多对可在同一台机器并行运行（每项目目录一对），但 Windows 尚不是官方支持平台。
• 自动恢复为实验性可选项，依赖配套 guard；Claude 侧恢复为尽力而为，只有在收到真实 ack_resume 后才标记为已恢复。
• 不是托管服务、多租户系统、通用编排框架，也不是不可信工具之间的加固安全边界。

跨网络协作（v3 预览） 0.1.31 版本提供跨机器的共享房间协作层，通过 broker 运行，包含 auth、broker、room、join 与 publish 命令；仅 Codex 的机器可使用原生房间工具交换消息与确认。设置与投递限制详见用户手册。

更新提示 abg claude 与 abg codex 在新稳定版发布时向 stderr 打印一行提示；检查为尽力而为、使用缓存结果、每日最多在后台执行一次、网络失败静默忽略。交互式 TTY 下会提示是否升级，15 秒无应答则忽略该版本。可用 NO_UPDATE_NOTIFIER=1 禁用，或用 AGENTBRIDGE_UPDATE_PROMPT=0 仅保留通知。