开源项目 GitHub Topic ai-coding 2026-07-06T12:02 正文 ok 564 words

📦 SeemSeam/claude_codex_bridge：混合 Codex、Claude 等智能体的可视化多智能体 CLI 工作台

英文标题：📦 SeemSeam/claude_codex_bridge

SeemSeam/claude_codex_bridge 是一个开源的多智能体 CLI 工作台，支持混合使用 Codex、Claude、Gemini、Kimi、Qwen 等 AI 编程代理进行复杂协作，并可通过手机远程控制终端和文件传输。最新版本 8.0.16 提供了强稳定的 agent 间通信、Rich 富媒体工作台、Agent Roles 角色系统与移动端重连增强，通过 npm 即可一键安装。对于开发者，该项目将多个 AI 编码工具编排进可见的窗口布局，并内置 daemon、Hub 并发和共享记忆，显著提升多模型协同开发效率。

打开原文相关 5.6 · 机会 4

1.3 KB

467 B

936 B

1.1 KB

1.4 KB

1.7 KB

464 B

470 B

2.8 KB

467 B

464 B

456 B

464 B

476 B

1.2 KB

2.0 KB

989.3 KB

380.9 KB

中文

强稳定的智能体间通信能力，支持 A -> B -> C、A,B -> C、A -> B,C 等复杂协作关系。
- 每个智能体都是完整原生终端，支持可见的界面排布和直接接管。
- 后台 daemon 持续运行，可以脱离前台界面保持项目状态。
- Hub 能力：一个命令同时并发运行多家 CLI provider。
- 手机远程控制器：跨 provider 语音操控、文件传输和远程终端访问。

推荐使用 npm 安装或更新：

npm install -g @seemseam/ccb

安装完成后，后续更新直接使用 CCB 自带 updater。

GitHub Release 包和源码安装兜底

如果当前环境不方便使用 npm，可以到 Releases 下载与你的平台匹配的包，解压后安装：

tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install

源码安装只建议开发或临时兜底使用：

git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install

源码安装会让全局 ccb / ask 链接回当前 checkout。普通用户更建议使用 npm 包。

在工作目录执行：

如果启动时提示无法自动创建 .ccb 或找不到项目锚点，需要手动创建 .ccb 作为项目锚点：

在项目根目录创建 .ccb/ccb.config。推荐使用 v2 [windows] 拓扑：window 内的智能体排布由 , 和 ; 控制上下堆叠和左右分栏，例如 A,B;C,D 接近四宫格布局。

version = 2

[windows]
main = "main:codex"
work = "worker1:codex(worktree), worker2:claude(worktree)"
review = "reviewer:claude, qa:gemini"

[ui.sidebar]
mode = "every_window"
width = "15%"
bottom_height = 20
agents_height = "50%"
comms_height = "15%"
tips_height = "35%"
comms_limit = 3

验证配置并启动工作台：

你可以直接在某个智能体窗格中输入，也可以让智能体之间协作：

/ask reviewer review the latest parser changes and list blocking issues.

也可以在工作编排中让智能体自动调用 /ask 完成委派和交接。建议通过修改智能体记忆或项目共享记忆 .ccb/ccb_memory.md 进行编排。

推荐使用手机控制 CCB：可以接入所有 CCB 项目，控制每个智能体，语音输入，并传递文件。

该命令会指导你完成安装和配置。

Mobile App 详情、安全边界和源码

CCB 8.0.16 已把 Flutter 版 CCB Mobile 源码放入 mobile/，并在 GitHub Release 中发布 Android APK：

手机端定位是远程控制真实服务器上的 CCB 项目。它可以从 server-wide mobile gateway 获取所有已挂载项目，切换 window/智能体，渲染智能体对话上下文，以 pane-native 输入方式发送文本，打开 terminal 视图，并通过认证 gateway 上传/下载图片和文档附件。

安全边界：

CCB gateway 只绑定 loopback，例如 127.0.0.1:8787。
远程访问使用 Tailscale Serve，不启用 Tailscale Funnel。
CCB 不保存 Tailscale 密码、OAuth token、admin API token，也不会自动修改 tailnet ACL/grants。
手机只获得 pairing profile 授权的 scope，例如 view、content、terminal、file upload 和 file download。

在终端查看文件结构、打开文件、编辑文档和预览媒体内容。

启用 Rich 模式后，普通 ccb 会自动打开 Rich WezTerm 启动器，仅当已经在 CCB 自身启动的 Rich WezTerm 中时才不会再次跳转；运行 ccb uninstall rich 可退回到普通终端启动。

CCB 支持 Agent Roles Spec：这是一个 host-neutral 的专业智能体封装规范，可把技能、记忆和工具依赖打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。

Role	基本功能
`agentroles.ccb_self`	CCB 自维护、配置辅助、运行诊断、受保护恢复和工作流编排。
`agentroles.archi`	架构审查、边界检查、耦合分析、可维护性风险和后续 gate 建议。
`agentroles.frontend_engineer`	前端设计与实现、设计系统、可访问性、浏览器 QA 和受审查的 AGY 委派。
`agentroles.mobile_app_engineer`	iOS、Android、React Native、Expo、Flutter、SwiftUI、Jetpack Compose 等移动端设计与实现。
`agentroles.mother`	Role 创建、Role source 审计、角色研究、蓝图设计和 Agent Roles 规范合规检查。
`agentroles.su_ccb`	SU-CCB 工作流操作，覆盖需求分析、计划、派发、审查 gate、归档和恢复。

如果你不确定应该如何分组、要几个 worker、哪些智能体用 worktree、哪些智能体需要独立模型或 API，可以直接问当前工作台里的 ccb_self。它是 CCB 内置的 self-agent，理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径，并能用私有 ccb-config skill 和你讨论后生成配置方案。空白项目默认包含 ccb_self；已有自定义配置可以用 ccb roles add agentroles.ccb_self:codex 添加。

.ccb/ccb_memory.md 是项目级共享记忆文档，适合记录团队协作规则、项目约束、长期上下文和智能体交接约定。把跨智能体的稳定信息放在这里，比把同一段说明复制到多个 provider 私有记忆里更可靠。

感谢 Linux.do 社区在测试、反馈和讨论中的支持。

感谢 tmux-agent-sidebar 提供的 sidebar 思路和启发。

v8.0.16 - Mobile 重连与窗格活动记录

CCB Mobile 终端模式增加自动重连诊断与恢复路径，断线时会显示“重新连接”，并在恢复后继续使用当前智能体窗格。
mobile gateway 在窗格输入路径记录项目活动，保证 mobile 项目列表最近使用排序能感知终端输入。
ccb update mobile 默认 APK 下载链接、README、package metadata 和 mobile release manifest 对齐到 8.0.16。

v8.0.12 - Release CI 可移植性与 README 多语言同步

mobile host registry 测试现在把临时 Unix socket 放到短的 /tmp/ccb-sock-* 路径，避免 macOS CI 触发 AF_UNIX path too long。
ccb update mobile、README 链接、package metadata 和 mobile release manifest 对齐到 8.0.12 APK。
中文 README 现在是 GitHub 主 README；英文迁移到 readme_en.md，并新增日语、法语、德语、阿拉伯语、西班牙语、葡萄牙语、韩语和俄语版本，所有语言保持同一章节结构。

v8.0.0 - CCB Mobile Monorepo 发布

Flutter 版 CCB Mobile 源码正式进入本仓库，并在 GitHub Release 中发布 Android APK。
新增 server-wide mobile 项目发现、配对、认证 gateway 路由、pane-native 消息输入、对话上下文渲染、terminal 访问，以及图片/文档上传下载能力。
将 ccb update mobile 提升为 Tailscale Tailnet onboarding 的统一入口，同时保持 gateway 仅监听 loopback，不启用 Funnel、不保存 token、不自动修改 ACL/grants。

v7.7.0 - Runtime Accelerator 发布加固

Release artifacts 现在会携带可选 Rust ccb-runtime-accelerator，安装版 Codex 智能体在预期存在 sidecar 时不再静默退回 Python 热路径。
当项目路径导致 Unix socket 路径过长时，accelerator socket 会自动落到短的 per-user runtime socket root。
加固 callback repair 和 Codex binding cache invalidation，并记录完整回归、长 idle Codex soak、Claude callback 和混合 provider 集成测试证据。

v7.6.19 - 长任务 ask 默认等待策略

普通长时间 ask 默认继续等待真实 provider/completion 结果，不再仅因 heartbeat 诊断自动 terminalize 为 incomplete/heartbeat_timeout。
Codex、Claude、Gemini 的 pane-backed no-terminal timeout 默认改为显式 opt-in，仍保留显式 reliability timeout 策略。
已用 32 分钟 source-runtime ask smoke 验证：任务超过 30 分钟仍保持 running，随后以 result_message 完成，未出现 heartbeat_timeout 或 incomplete 证据。

完整历史请看 CHANGELOG.md。

English / 原文

强稳定的 agent 间通信能力，支持 A -> B -> C、A,B -> C、A -> B,C 等复杂协作关系。
- 每个 agent 都是完整原生终端，支持可见的界面排布和直接接管。
- 后台 daemon 持续运行，可以脱离前台界面保持项目状态。
- Hub 能力：一个命令同时并发运行多家 CLI provider。
- 手机远程控制器：跨 provider 语音操控、文件传输和远程终端访问。

推荐使用 npm 安装或更新：

npm install -g @seemseam/ccb

安装完成后，后续更新直接使用 CCB 自带 updater：

GitHub release 包和源码安装兜底

如果当前环境不方便使用 npm，可以到 Releases 下载与你的平台匹配的包，解压后安装：

tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install

源码安装只建议开发或临时兜底使用：

git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install

源码安装会让全局 ccb / ask 链接回当前 checkout。普通用户更建议使用 npm 包。

在工作目录执行：

如果启动时提示无法自动创建 .ccb 或找不到项目锚点，需要手动创建 .ccb 作为项目锚点：

在项目根目录创建 .ccb/ccb.config。推荐使用 v2 [windows] 拓扑：window 内的 agent 排布由 , 和 ; 控制上下堆叠和左右分栏，例如 A,B;C,D 接近四宫格布局。

version = 2

[windows]
main = "main:codex"
work = "worker1:codex(worktree), worker2:claude(worktree)"
review = "reviewer:claude, qa:gemini"

[ui.sidebar]
mode = "every_window"
width = "15%"
bottom_height = 20
agents_height = "50%"
comms_height = "15%"
tips_height = "35%"
comms_limit = 3

验证配置并启动工作台：

你可以直接在某个 agent pane 里输入，也可以让 agent 之间协作：

/ask reviewer review the latest parser changes and list blocking issues.

也可以在工作编排中让 agent 自动调用 /ask 完成委派和交接。建议通过修改 agent 记忆或项目共享记忆 .ccb/ccb_memory.md 进行编排。

推荐使用手机控制 CCB：可以接入所有 CCB 项目，控制每个 agent，语音输入，并传递文件。

该命令会指导你完成安装和配置。

Mobile App 详情、安全边界和源码

CCB 8.0.16 已把 Flutter 版 CCB Mobile 源码放入 mobile/，并在 GitHub Release 中发布 Android APK：

手机端定位是远程控制真实服务器上的 CCB 项目。它可以从 server-wide mobile gateway 获取所有已挂载项目，切换 window/agent，渲染 agent 对话上下文，以 pane-native 输入方式发送文本，打开 terminal 视图，并通过认证 gateway 上传/下载图片和文档附件。

安全边界：

CCB gateway 只绑定 loopback，例如 127.0.0.1:8787。
远程访问使用 Tailscale Serve，不启用 Tailscale Funnel。
CCB 不保存 Tailscale 密码、OAuth token、admin API token，也不会自动修改 tailnet ACL/grants。
手机只获得 pairing profile 授权的 scope，例如 view、content、terminal、file upload 和 file download。

在终端查看文件结构、打开文件、编辑文档和预览媒体内容。

rich 启用后，普通 ccb 会自动打开 rich WezTerm launcher，只有当当前已经处于 CCB 自己拉起的 rich WezTerm 中时才不会再次跳转；运行 ccb uninstall rich 可退回普通终端启动。

CCB 支持 Agent Roles Spec：这是一个 host-neutral 的专业 agent 封装规范，可把 skills、记忆和工具依赖打包成可安装、可挂载、可卸载的 Role Pack。该仓库同时也是公开角色库。

Role	基本功能
`agentroles.ccb_self`	CCB 自维护、配置辅助、运行诊断、受保护恢复和工作流编排。
`agentroles.archi`	架构审查、边界检查、耦合分析、可维护性风险和后续 gate 建议。
`agentroles.frontend_engineer`	前端设计与实现、设计系统、可访问性、浏览器 QA 和受审查的 AGY 委派。
`agentroles.mobile_app_engineer`	iOS、Android、React Native、Expo、Flutter、SwiftUI、Jetpack Compose 等移动端设计与实现。
`agentroles.mother`	Role 创建、Role source 审计、角色研究、蓝图设计和 Agent Roles 规范合规检查。
`agentroles.su_ccb`	SU-CCB 工作流操作，覆盖需求分析、计划、派发、审查 gate、归档和恢复。

如果你不确定应该如何分组、要几个 worker、哪些 agent 用 worktree、哪些 agent 需要独立模型或 API，可以直接问当前工作台里的 ccb_self。它是 CCB 内置的 self-agent，理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径，并能用私有 ccb-config skill 和你讨论后生成配置方案。空白项目默认包含 ccb_self；已有自定义配置可以用 ccb roles add agentroles.ccb_self:codex 添加。

.ccb/ccb_memory.md 是项目级共享记忆文档，适合记录团队协作规则、项目约束、长期上下文和 agent 交接约定。把跨 agent 的稳定信息放在这里，比把同一段说明复制到多个 provider 私有记忆里更可靠。

感谢 Linux.do 社区在测试、反馈和讨论中的支持。

感谢 tmux-agent-sidebar 提供的 sidebar 思路和启发。

v8.0.16 - Mobile 重连与 pane 活动记录

CCB Mobile Terminal 模式增加自动重连诊断与恢复路径，断线时会显示 Reconnecting，并在恢复后继续使用当前 agent pane。
mobile gateway 在 pane 输入路径记录项目活动，保证 mobile 项目列表最近使用排序能感知 Terminal 输入。
ccb update mobile 默认 APK 下载链接、README、package metadata 和 mobile release manifest 对齐到 8.0.16。

v8.0.12 - Release CI 可移植性与 README 多语言同步

mobile host registry 测试现在把临时 Unix socket 放到短的 /tmp/ccb-sock-* 路径，避免 macOS CI 触发 AF_UNIX path too long。
ccb update mobile、README 链接、package metadata 和 mobile release manifest 对齐到 8.0.12 APK。
中文 README 现在是 GitHub 主 README；英文迁移到 readme_en.md，并新增日语、法语、德语、阿拉伯语、西班牙语、葡萄牙语、韩语和俄语版本，所有语言保持同一章节结构。

v8.0.0 - CCB Mobile Monorepo 发布

Flutter 版 CCB Mobile 源码正式进入本仓库，并在 GitHub Release 中发布 Android APK。
新增 server-wide mobile 项目发现、配对、认证 gateway 路由、pane-native 消息输入、对话上下文渲染、terminal 访问，以及图片/文档上传下载能力。
将 ccb update mobile 提升为 Tailscale Tailnet onboarding 的统一入口，同时保持 gateway 仅监听 loopback，不启用 Funnel、不保存 token、不自动修改 ACL/grants。

v7.7.0 - Runtime Accelerator 发布加固

Release artifacts 现在会携带可选 Rust ccb-runtime-accelerator，安装版 Codex agent 在预期存在 sidecar 时不再静默退回 Python 热路径。
当项目路径导致 Unix socket 路径过长时，accelerator socket 会自动落到短的 per-user runtime socket root。
加固 callback repair 和 Codex binding cache invalidation，并记录完整回归、长 idle Codex soak、Claude callback 和混合 provider 集成测试证据。

v7.6.19 - 长任务 ask 默认等待策略

普通长时间 ask 默认继续等待真实 provider/completion 结果，不再仅因 heartbeat 诊断自动 terminalize 为 incomplete/heartbeat_timeout。
Codex、Claude、Gemini 的 pane-backed no-terminal timeout 默认改为显式 opt-in，仍保留显式 reliability timeout 策略。
已用 32 分钟 source-runtime ask smoke 验证：任务超过 30 分钟仍保持 running，随后以 result_message 完成，未出现 heartbeat_timeout 或 incomplete 证据。

完整历史请看 CHANGELOG.md。