支持哪些 AI 编程工具?Bot Crossing 已适配 Claude Code、Codex、Cursor 等 7 大 Harness 详解

原创2026-10-25 19:55:472,288 阅读

支持哪些 AI 编程工具?Bot Crossing 已适配 Claude Code、Codex、Cursor 等 7 大 Harness 详解

Bot Crossing 是一款免费开源的本地可视化小游戏:它把电脑上所有 AI 编程代理会话变成会走路、会建造的小机器人,让你在一个 3D "殖民地" 里一眼看清每个 AI 编程工具正在忙什么。目前已适配 7 大 AI 编程工具——Claude Code、Codex、Cursor、Antigravity CLI、Hermes、Kilo Code 和 OpenCode,并自动检测你的机器上安装了哪些。

本文带你逐个了解这 7 个已适配的 Harness(AI 编程代理运行器),以及它们是怎么被读取、检测和打开的。

先搞懂:什么是 Harness,Bot Crossing 如何读取 AI 编程会话?

Harness 就是实际运行你 AI 代理会话的那个工具本身——Claude Code、Codex CLI、Cursor 等。

Bot Crossing 不关心你用的是哪个工具:它为每个 Harness 写了一个小型适配器,只读取该工具保存在本地的会话文件。所有适配器和注册表都集中在 server/harnesses/ 目录:

每个适配器只需实现四个小接口:detect()(检测本机是否安装)、scanThreads()(列出全部会话)、openThread()(打开会话)和 newSession()(新建会话)。

Bot Crossing 中由 AI 编程会话化身的小机器人(宇航员)形象对比

只读承诺:Bot Crossing 从不写入任何 AI 编程工具的数据——唯一的写文件是 data/colony.json(存殖民地布局)。工具自己的会话记录一个字都不会被改动。

7 大已适配 AI 编程工具逐个详解 ✨

Harness 厂商/来源 读取内容 如何打开会话
Claude Code Anthropic 桌面端记录 + CLI 转录,含 worktree 与实时进程检测 深链接直达桌面应用
Codex OpenAI 桌面、VS Code 插件与 CLI 三路合并 通过 codex:// 打开
Cursor Anysphere agent 转录文件 通过深链接打开
Antigravity CLI Google 会话转录 通过 antigravity:// 打开
Hermes 终端/聊天应用代理 每个 pilot profile 的会话 无深链接(按钮置灰)
Kilo Code VS Code 扩展 顶层会话(SQLite 数据库) 在 VS Code 中打开仓库文件夹
OpenCode 开源 CLI 顶层会话(SQLite 数据库) 新会话走 opencode://

1️⃣ Claude Code(Anthropic)——支持最完整

适配器:server/harnesses/claude-code.mjs

同时读取桌面端的会话记录和 CLI 的 JSONL 转录(~/.claude/projects/…),是唯一支持 worktree 和实时进程检测的适配器:正在运行的 Claude 会话会被识别,对应机器人会在地图上挥锤干活。打开线程时走桌面应用的深链接;纯 CLI 会话则回退到 resume 方式导入。

2️⃣ Codex(OpenAI)——三端数据合并

适配器:server/harnesses/codex.mjs

Codex 的桌面端、VS Code 插件和 CLI 共用一套存储:~/.codex/state_<n>.sqlite 里有一行一个线程的元数据(标题、分支、模型、归档状态),而 ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl 是转录正文。适配器把两个数据源按会话 id 合并,既不丢转录大小,也不漏掉数据库还没索引的新会话。

3️⃣ Cursor(Anysphere)——读取 agent 转录

适配器:server/harnesses/cursor.mjs

读取 ~/.cursor/projects/<目录>/agent-transcripts/ 下的每个 agent 会话 JSONL 文件。由于文件里只存了 { role, message } 对话内容,项目名和标题都是从目录编码和第一条用户消息推断的。注意:composer / 侧边栏线程暂未读取,官方文档中已如实标注。

4️⃣ Antigravity CLI(Google)——Gemini CLI 的继任者

适配器:server/harnesses/antigravity.mjs

读取 ~/.gemini/antigravity-cli/brain/<sessionId>/ 下的转录文件,打开会话走 antigravity:// 深链接。它是 Google 停止为个人账号提供 Gemini CLI 之后的替代方案,Bot Crossing 已第一时间跟上。

5️⃣ Hermes——按 pilot profile 分区的会话库

适配器:server/harnesses/hermes.mjs

只读打开 ~/.hermes/state.db 中的 sessions 表,每个扫描周期一次 SQL 查询,500 个会话的库毫秒级返回。因为 Hermes 活在终端和聊天应用里,没有可深链接的目标,所以"打开"按钮在界面中会置灰——适配器会如实说明原因,而不是假装点击成功。

6️⃣ Kilo Code(VS Code 扩展)

适配器:server/harnesses/kilocode.mjs

会话全部存在本地 SQLite 库 ~/.local/share/kilo/kilo.db(WAL 模式,应用运行时并发读也安全)。只统计顶层会话——带 parent_id 的子行是任务子代理,不算线程。打开一个线程等价于在 VS Code 里打开它的仓库文件夹,Kilo 侧边栏的会话列表就在那里。

7️⃣ OpenCode

适配器:server/harnesses/opencode.mjs

与 Kilo Code 结构类似:读取 ~/.local/share/opencode/opencode.db,只取顶层会话。上游没有单会话深链接,因此"打开"会如实拒绝,而新建会话走已注册的 opencode://new-session 处理器。

Bot Crossing AI 编程代理机器人面罩反射效果前后对比

自动检测:装了什么就显示什么 🤖

detectedHarnesses() 在每次扫描时对 7 个适配器各跑一次 detect()(通常是"数据目录是否存在"),所以你在殖民地打开时安装某个工具,下次轮询就会自动出现在地图上,无需重启。

验证很简单,应用运行中执行:

curl -s localhost:5274/api/harnesses

返回每个已注册 Harness 的 detected 状态。某个适配器的 scanThreads() 抛错也不会拖垮整个扫描——server/scan.mjs 会跳过出错的适配器、继续处理其余工具。

快速跑起来:完整安装步骤 🚀

git clone https://gitcode.com/gh_mirrors/bo/bot-crossing
cd bot-crossing
npm install && npm run dev

要求 Node 22.13 或更新版本。npm run dev 就是全部:API 内嵌在 Vite 开发服务器里,没有第二个进程。默认只绑定 127.0.0.1,纯本地运行、无账号、不上传任何数据。

Bot Crossing 殖民地中每个 AI 编程会话对应的建筑与机器人

想让 Bot Crossing 支持更多 AI 编程工具?写一个适配器即可 📦

目前 Amp、Aider、Goose、Qwen Code、Amazon Q Developer CLI 等还在 README 适配清单 中列为"Not yet"。但扩展成本极低:

  1. 在 server/harnesses/ 新建一个适配器文件
  2. 在 server/harnesses/index.mjs 的 HARNESSES 列表加一行

扫描器、API 和浏览器端一行都不用改——这就是适配器接口的设计初衷。完整的接口契约、Thread 字段说明(project、lastActivityAt、running、hasError 等如何映射到机器人的外观和行为)、以及"找到某个工具把会话存哪儿"的技巧,都写在 server/harnesses/README.md 里,欢迎提 PR 贡献。

小结

Bot Crossing 用"一个适配器 = 一个文件"的干净架构,把 7 个主流 AI 编程工具统一变成了殖民地里的机器人:读什么、怎么检测、如何打开,全部有据可查。无论你日常主力是 Claude Code 还是 Codex,npm run dev 之后,你的所有 AI 编程会话都会以一只挥锤的小宇航员出现在地图上。

登录后查看全文
bot-crossing