并行跑十个 agent 之后,先撑不住的会是你的 git 仓库

这一年 coding agent 的宣传口径一直很一致:它能无人值守地跑,所以你应该同时跑几个。五个、十个、更多。一个改认证,一个修那个不稳定的测试,一个做谁都不想碰的迁移。
工具基本撑得住。然后你真的去试了,坏掉的东西原来是你的工作目录。
两个 agent 在同一个 checkout 里一分钟内就会互相覆盖文件。修法 git 在 2015 年就有了:worktree,让每个分支有自己的目录,同时共用一个对象库。git 能做这件事。git 做这件事的接口难用到大部分人从来没碰过。
Worktrunk 是一个用 Rust 写的 CLI,专门修那个接口。它 1.19 万星,其中约 2200 来自过去一周,许可 MIT 或 Apache-2.0,看你选哪个。
打三遍字的问题
在 git 里创建一个 worktree 要把分支名打三遍:
git worktree add -b feat ../repo.feat cd ../repo.feat
三遍里有两遍是多余的。它们存在是因为命令要一个路径和一个分支,而路径几乎总是能从分支推出来。听起来是个小麻烦。它是 worktree 一直停留在「有强观点的人才用」而不是默认做法的原因。
Worktrunk 用分支名来指代 worktree,路径按可配置模板算出来。任何接受分支的命令也接受该分支所在 worktree 的路径。于是那段尴尬的三步舞变成:
wt switch -c -x claude feat
建分支、建它的 worktree、在里面起 Claude,从你当前所在的任何地方。`-x` 在切换之后跑一个命令,你在分隔符后面追加的内容会传给它,这就是你把第一条指令交给 agent 的方式。
三条这样的命令,你就有三个 agent 在三个分支上,互相隔离,彼此不需要协调。
安装
macOS 或 Linux 用 Homebrew:brew install worktrunk && wt config shell install。Cargo、pacman、conda-forge、pixi 都能装。Windows 是 winget install max-sixty.worktrunk,然后 git-wt config shell install。
Windows 那条注释值得重复,因为它一定会坑到人:wt 已经指向 Windows 终端,所以 Winget 把工具装成 git-wt 来避开冲突。你也可以在应用执行别名里关掉 Windows 终端的别名,直接用 wt。
config shell install 这一步不能省。它装的是让命令能改变当前目录的 shell 钩子,也就是 wt switch 全部的机制。跳过它,每条命令看起来都什么也没做。
真正要紧的四条命令
wt switch 移动你。wt list 列出所有 worktree 和状态标记:@ 是当前位置,+ 是有暂存改动,↑1 是领先 main 一个提交,⇡ 是有未推送的提交。光是这个输出就比 git worktree list 强,后者只给你路径。
wt remove 收拾,把 worktree 和分支一起删掉,在 git 里是两条命令,还要在一个地方搞错。
wt merge main 是最有意思的。它 squash 当前分支、rebase 到 main、快进合并、删掉 worktree,一步。如果你曾经在三个并行分支上把同一个冲突解了三遍,你就知道它为什么存在。并行会放大合并问题,而合并问题本来就是这份工作里最不愉快的部分。
还有 wt switch pr:123,直接跳到某个 PR 背后的分支。小功能,生活质量不成比例。
存储是没人提醒你的那部分
十个 worktree 就是十份 node_modules 和十份 target/。在笔记本上是几百 GB,而且每一份第一次 cargo build 都是四分钟。
Worktrunk 用写时复制的构建缓存处理这个。在支持的文件系统上,macOS 的 APFS、Linux 上带 reflink 的 btrfs 和 XFS,worktree 共享构建目录,只在文件改变时才分叉。第一次构建付账,后面九次借用。
这类功能会暴露作者到底拿工具在干什么。没有人会给 worktree 管理器加共享构建缓存当作营销动作。他们是在第四次把磁盘塞满之后加的。
相关的细节是 hash_port,一个模板过滤器,给每个 worktree 分一个唯一端口。十个 worktree,十个开发服务器,不撞端口,不用手工记账。配上一个装依赖、起服务的 post-start 钩子,新 worktree 在 agent 启动那一刻就是可用的。
钩子是锋利的那一面
钩子在定义好的时机自动跑 shell 命令:worktree 启动之后、合并之前、合并之后。post-start 钩子就是你白得环境初始化的方式。
它们也是由一次 git 操作触发的任意代码执行。一个仓库可以带一份配置,在 wt switch 时跑点什么,如果你克隆了它、切进一个分支,你就跑了。这跟 npm install 跑 postinstall 是同一类风险,值得同样的对待:信一个仓库之前先读配置。
工具自己的回答是钩子声明在你能控制的配置里。这够不够取决于你的威胁模型,对任何会克隆陌生仓库的人,这事值得想一想。
它没修掉什么
worktree 共用一个 .git 目录,意味着共用分支引用、stash 和配置。两个 agent 不能 checkout 同一个分支。在一个 worktree 里 git rebase 会改动另一个 worktree 正坐在上面的历史。reflog 条目交错的方式会让事后取证更麻烦。
Worktrunk 让常见情况舒服,没有改变底层模型。如果你的 agent 需要真正独立的仓库,你要的是分开克隆,代价是失去让 worktree 变便宜的那个共享对象库。
还有一个工具不碰的协调问题。十个 agent 分在十个分支上,会产出十个动到同样三个文件的 PR,再多的 worktree 管理也不能让它们干净合并。真正从并行里拿到价值的团队,看起来是那些分配不重叠区域的,而不是跑最多 agent 的。
为什么这类工具在赢注意力
agent 框架拿走发布会。让 agent 能用的那些工具拿走星数。
这个模式这一年重复了很多次:记忆层、权限模式、沙箱、worktree 管理器。每一个之所以存在,都是因为模型已经好到能干那个活,而周围环境从来没为一个不会累、不会提问、会安安静静在错误目录里跑四十分钟的工人设计过。
Worktrunk 是对其中一个缺口小而专注的回答。它那 1.19 万颗星不是对 Rust 或对 git 的表态。它们数的是那些试着同时跑三个 agent、然后发现难的部分在文件系统上的开发者。
相关文章
一份社区维护的点击表,关掉了国产 Android 系统里的广告
它不动系统,不解锁,不刷机,只把厂商本来就留出来的开关一个个拨过去。代价是这份名单得一直有人续写。
GPT Image 2.6 守住 token 价格,账单却涨了
GPT Image 2.6 沿用了 2.5 的全部 token 费率,单张图却更贵,因为更多的活现在花在输出 token 上。上线十一天,定价结构说的比排行榜更多。
有人从外部重建了 IDM,并写下了自己没有碰过的部分
Mister Download Manager 用 Rust 重写了 Internet Download Manager 的下载流程,声称速度快 5 倍、支持 86 种语言。更值得细读的,是它解释如何在不复制任何代码的前提下完成重写的那一段。
Rune 是一个 Rust UI 框架,设计初衷是让 agent 能检查自己的工作
Rune 能无头渲染、导出元素树并接受脚本化输入,这让编码 agent 拿到截图永远给不了的东西,一个可 diff 的信号。这个框架仍是预发布版本,不接受 pull request。