支持哪些 AI 编程工具?Bot Crossing 已适配 Claude Code、Codex、Cursor 等 7 大 Harness 详解
支持哪些 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/ 目录:
- 注册表:server/harnesses/index.mjs —— 一行代码列出全部 7 个适配器
- 适配器接口文档:server/harnesses/README.md
- 与 Harness 无关的扫描器:server/scan.mjs
每个适配器只需实现四个小接口:detect()(检测本机是否安装)、scanThreads()(列出全部会话)、openThread()(打开会话)和 newSession()(新建会话)。
只读承诺: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 | 会话转录 | 通过 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 处理器。
自动检测:装了什么就显示什么 🤖
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 编程工具?写一个适配器即可 📦
目前 Amp、Aider、Goose、Qwen Code、Amazon Q Developer CLI 等还在 README 适配清单 中列为"Not yet"。但扩展成本极低:
- 在
server/harnesses/新建一个适配器文件 - 在 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 编程会话都会以一只挥锤的小宇航员出现在地图上。


