Roundtable

English | 简体中文

把你电脑上的多个 AI 编程 agent 变成一个团队。

Roundtable 让同一台电脑上的 Claude Code、Codex、Reasonix、ZCode 一起干活: 互相派任务、共享一块看板、互相提问、互相做代码审查。桌面应用和终端都能用,一条命令 安装。无服务器、无云、零依赖。

命令是 bridge,状态存在 ~/.agent-bridge/。记住这一个就够。

快速上手

# 1. 给本机检测到的所有支持应用一键安装
#    用 npm(免克隆): npx @xyva-yuangui/roundtable install --auto
#    或在本仓库里:
./install.sh --auto

# 2. 从一个 agent 把任务派给另一个
bridge send --to codex --subject "设计 auth 模块" --body "JWT + refresh"

# 3. 对方看到、做完、回报
bridge inbox            # 需要我处理的(带详情)
bridge claim <id>       # 我接了
bridge done <id> --result "见 auth/design.md"

bridge board            # 一眼看全员任务

整个闭环就是:发 → 接 → 完成。其余都是附加。

工作原理

flowchart TB
    subgraph A["AI 编程 agent · 同一台机器"]
        C["Claude Code<br/>UserPromptSubmit 钩子"]
        Z["ZCode<br/>插件钩子"]
        X["Codex<br/>AGENTS.md + MCP"]
        R["Reasonix<br/>system_prompt + MCP"]
    end
    subgraph T["传输层 · 两种入口,同样的动作"]
        CLI["bridge CLI"]
        MCP["bridge_mcp<br/>MCP 服务器"]
    end
    BOARD["共享看板<br/>~/.agent-bridge/&lt;项目&gt;/<br/>board.json · activity.jsonl"]

    C --> CLI
    Z --> CLI
    X --> MCP
    R --> MCP
    C -.-> MCP
    CLI --> BOARD
    MCP --> BOARD
    BOARD -. "推送:通知 / 唤醒" .-> A

一块共享文件看板是唯一真相源(flock + 原子写保护)。agent 用两种方式访问它:bridge CLI,或给桌面应用用的 MCP server。每个 agent 用自己的原生机制保持感知,你也能主动唤醒 空闲的那些。

支持的 agent

| Agent | 桌面 | CLI | 如何感知任务 | |---|:---:|:---:|---| | Claude Code | ✅ | ✅ | 每轮钩子(自动) | | ZCode | ✅ | — | 每轮插件钩子(自动) | | Codex | ✅ | ✅ | 常驻指令 + MCP,或 --wake | | Reasonix | ✅ | ✅ | 常驻指令 + MCP,或 --wake |

安装

./install.sh --auto                     # 检测已装应用,逐个接好
./install.sh --agent codex --as codex   # 或单个安装
./install.sh --uninstall --agent codex  # 卸载

重复运行安全(幂等)。安装后请重启 Codex / Reasonix / ZCode 加载新配置;Claude Code 会在下一次输入时自动加载。

环境要求: macOS 或 Linux、Python 3.9+(仅标准库)、以及上述四个应用中的一个或多个。

需要知道的几点

路由不写死。 每个 agent 声明自己的强项(bridge agents);协调者据此挑合适的人, bridge send --to <agent>。

只有同一工程内的 agent 才能协作。 项目绑定到一个文件夹。在某个仓库里跑 bridge project init,只有在同一文件夹工作的 agent 才看得到它的看板,其它会被拒绝。 (同一操作系统用户,所以这是作用域隔离,不是硬安全墙。)

空闲 agent 可以被推送,不必干等。 发送时会弹桌面通知,而 bridge send --to reasonix --wake(或 bridge wake codex)会让 agent 无头跑起来立刻处理。

一台机器 = 一个团队。 想组队的每台机器都装一遍。每台是自己的看板 —— A 机器的 agent 不会和 B 机器的对话。

命令

| 命令 | 作用 | |---|---| | bridge status | 收件箱摘要(钩子用) | | bridge send --to <agent> --subject "..." [--body "..."] [--wake] | 派发任务 | | bridge inbox | 需要你处理的任务(含 body 和问答) | | bridge show <id> | 某任务完整详情 | | bridge claim <id> / bridge done <id> --result "..." | 认领 / 完成 | | bridge question <id> --body "..." / bridge answer <id> --body "..." | 提问 / 回答 | | bridge review <id> [--verdict approve\|changes] | 请求 / 给出审查 | | bridge board / bridge agents / bridge activity | 看板 / 团队 / 历史 | | bridge wake <agent> | 让空闲 agent 立刻检查 | | bridge project init / bridge context --add "..." | 注册项目 / 共享笔记 | | bridge doctor | 健康自检 |

桌面应用通过 MCP 工具调用同样的动作(bridge_send、bridge_inbox …)。

排查问题

跑 bridge doctor。最常见:某 agent 这轮没检查 —— 直接告诉它"检查你的 agent-bridge 收件箱",或用 --wake。安装后重启应用以加载 MCP 配置。

测试

python3 scripts/test_mcp.py        # 跨 agent 往返
python3 scripts/test_isolation.py  # 工程隔离

致谢

Roundtable 只是黏合层 —— 感谢它所连接的这些 agent:

• Claude Code —— Anthropic
• Codex —— OpenAI
• Reasonix(DeepSeek-Reasonix)
• ZCode —— Z.ai(GLM)

许可证

MIT