Roam 让同机编程助手交接绕开 Git
Roam 支持让 OpenCode、Claude Code、Codex 和 Cursor 通过私有 Git 仓库跨设备接续会话。2.5.1 改为在同机直接写本地文件,跨机才经 Git 投递消息,各设备的对话副本独立存放。
AI 深度解读
同一台机器上的两个 coding agent 互相留便条,也要先走一轮 git pull + git push,耗时约 5 秒。Roam 作者在 2.5.1 修掉了这条绕路:同机直接写本地文件,跨机器才通过 git 传递。
这次改动带出的判断比补丁更有意思:git 可以负责送消息,但不必负责保存整段对话。对于用 OpenCode、Claude Code、Codex、Cursor 在多台设备间接续工作的程序员,这篇短文提供了一个值得借鉴的职责划分。
同一台机器上的消息,为什么还要经过 git
Roam 的用途,是让 coding agent 通过用户自己的私有 git 仓库,在另一台机器上接续会话。原文列出的工具包括 OpenCode、Claude Code、Codex 和 Cursor。
跨机器需要一条传递路径,私有 git 仓库承担这个角色很容易理解。但旧实现把同机 agent 之间的便条也送上了这条路径:即使消息根本不用离开本地磁盘,仍然执行 git pull + git push。
作者给出的耗时是约 5 秒。这是作者对旧流程的描述,原文没有提供测试环境、样本数量或耗时分布,不能把它当成所有环境下的固定延迟。
2.5.1 的修正很直接:同一台机器上,便条就是一次本地文件写入,不进入 git。原文没有公布修改后的耗时,所以能确认的是省掉了不必要的 git 操作,具体快了多少没有数据。
git 负责送达,对话副本留在各台机器
作者把修改后的分工归纳成三条:
- 同机 agent 互传便条,直接写本地文件,便条不进入 git。
- 不同机器之间传递内容,git 充当送达路径。
- 每台机器都保留自己的对话副本,这些副本位于 git 之外。
这里需要分清「传递」和「保存」。传递解决另一台机器如何拿到内容;保存解决这台机器在哪里保留自己的对话记录。两件事可以由不同机制承担。
git 是传输通道,不是对话数据库。
这句话不代表跨机器传递完全不经过仓库,而是说,对话的本地副本不再被等同于仓库里的持久记录。至于跨机器投递的具体文件格式、拉取时机、投递后的清理方式,原文都没有展开。
开头提到的「22 GB git story」也只是前文线索。这篇没有解释 22 GB 如何产生,更没有给出修复后的仓库体积,不能据此推断它解决了多少存储问题。
我的判断
我赞同这次改动的边界:已经处在同一台机器上的通信,没有必要为了复用跨机器流程,再执行一轮远端同步。它首先是一次消除多余步骤的修正。
但「git 适合作为 agent 的传输通道」仍然有前提。会话能在另一台机器上接起来,不等于消息可靠性已经得到验证。重复投递、并发写入、离线恢复和失败重试如何处理,作者没有交代。
和单纯依赖本地文件相比,git 路径承担了跨机器传递;和专门的消息服务相比,这篇没有给出延迟、可靠性或维护成本的对照数据。因此,它更适合作为一条设计经验来读,还不足以支持一般团队直接照搬整套方案。
能拿来做什么
- 如果你在同一台开发机上让多个 coding agent 交接任务,可以先检查交接是否触发了不必要的 git pull + git push,再判断本地文件能否满足需求。
- 如果你需要在多台设备之间接续 AI 编程会话,可以借鉴「传递路径与本地对话副本分开」的设计,明确每份数据放在哪里、由谁更新。
- 如果准备采用 Roam,可以把 2.5.1 的同机便条行为作为核验点,同时检查跨机器中断后如何恢复;原文没有提供这些细节,需要实际验证。