Worktrunk：把 Git Worktree 变成”切分支”，为并行 AI Agent 而生

当 Claude Code、Codex 这类能长时间无人值守跑任务的 AI agent 出现后，一个现实问题浮出水面：一个人同时挂 5–10 个 agent，它们会互相踩踏彼此的工作区。Git 原生的 worktree 正好解决这个问题——给每个 agent 一个独立的工作目录。但原生 worktree 的命令行体验极其笨重，连”新建一个 worktree”都要把分支名敲三遍。Worktrunk 就是为抹平这层粗糙 UX 而生的 CLI（作者 max-sixty，仓库 max-sixty/worktrunk），定位非常明确：为并行 AI agent 工作流设计的 Git worktree 管理器。

一、为什么需要它：原生 worktree 的 UX 税

Git worktree 的能力本身没问题：一个仓库可以同时 checkout 出多个工作目录，每个目录对应一个分支，互不干扰，非常适合并行任务。问题在交互。官方文档举的例子很说明问题——新开一个 worktree 原生要敲：

git worktree add -b feat ../repo.feat
cd ../repo.feat

分支名 feat 要在命令里打一遍、路径里打一遍，再手动 cd 进去。当你同时维护 5 个以上 worktree 时，记住哪个分支对应哪个目录、哪个目录改了什么、哪个已经可以删了，全靠人脑。Worktrunk 的主张是：worktree 应该像 branch 一样被地址化——你只关心分支名，路径由可配置模板自动算出来。

二、三个核心命令

Worktrunk 把日常操作压缩成四个动词：wt switch、wt list、wt merge、wt remove。官方给的对照表：

wt list 的输出远比原生丰富：每行展示分支、暂存状态（+）、相对 main 领先/落后的提交数（↑1/⇡）、未推送标记、commit hash、提交时长与提交信息。@ 标记当前所在 worktree。

-x 是为 agent 场景设计的关键开关：切换后自动执行一条命令，-- 之后的参数传给它。于是”开一条新分支并让 Claude 去干活”就是一行：

wt switch -x claude -c feature-a -- 'Add user authentication'

三、超越目录切换：hooks、LLM 提交与共享构建缓存

Worktrunk 没有停留在”更好用的 cd”。它的差异化集中在几个为多 agent / 多分支场景准备的机制：

• Hooks：在 create、pre-merge、post-merge 等生命周期点挂自定义命令，自动装依赖、起 dev server；
• LLM 提交信息：从 diff 自动生成 commit message，wt merge main 演示里能看到它自动生成”Add authentication module”并完成 squash/rebase/快进合并/清理一条龙；
• 交互式选择器：浏览 worktree 时流式展示 CI 状态、diff/log/PR/评论预览；
• 共享构建缓存：这是最有工程含量的一点——在 APFS、btrfs、XFS 上利用写时复制（CoW），让 10 个 worktree 直接共享 target/、node_modules/，既不用重新构建，也不用真实拷贝；
• PR 直达：wt switch pr:123 直接切到某个 PR 的分支；hash_port 模板过滤器让每个 worktree 拿到不同端口，避免并行起 dev server 撞端口；
• wt list --full：每个分支附带 CI 状态与 AI 生成的摘要。

四、安装与平台

安装渠道相当全：macOS/Linux 用 Homebrew（brew install worktrunk）、Rust 生态用 cargo install worktrunk、Arch 用 pacman、conda/pixi 也有社区维护的 feedstock。Windows 通过 winget 安装——这里有个真实的坑：Windows Terminal 自带 wt 命令别名，所以 winget 把 Worktrunk 装成 git-wt 以避免冲突，用户也可以手动关闭 Terminal 的应用执行别名后直接用 wt。装完都要跑 wt config shell install 做 shell 集成，否则”切换目录”这种动作无法真的改变当前 shell 的 cwd——这是个容易被忽略的前置步骤。二进制免费签名由 SignPath.io 提供。

五、客观分析：优势与局限

优势：

1. 精准踩中并行 agent 的真实痛点：当一个开发者同时跑多个 AI agent，worktree 的”目录即隔离”正好契合，而 Worktrunk 把切换、起 agent、合并、清理串成了一行命令；
2. CoW 共享缓存是真金白银的省时间：Rust/Node 项目依赖安装动辄几分钟，10 个 worktree 各自装一遍完全是浪费；
3. 不重复造轮子：复用 git 原生 worktree，不引入新的状态模型，学习成本低。

局限（官方文档已披露或可从其描述推断）：

1. CoW 共享缓存依赖文件系统：明确只在 APFS（macOS）、btrfs、XFS 上生效；最常见的 ext4 与 Windows NTFS 上拿不到这个红利；
2. 强依赖 shell 集成：不跑 wt config shell install，switch 并不会真的带你进目录，这与”像切分支一样自然”的宣传有落差；
3. Windows 命令名冲突：wt/git-wt 双轨增加了认知负担；
4. 面向单人/单仓的并行：它解决的是”一个人机器上多个 agent 分支”，并不涉及多机或远程 worktree 调度。

六、适合谁

• 同时挂多个 Claude Code / Codex 会话、被目录混乱折磨的开发者；
• 用 monorepo、每次装依赖都心疼的团队（在 APFS/btrfs/XFS 上收益最大）；
• 已经熟悉 git worktree 但嫌原生命令啰嗦的人。如果你从不并行开分支、也不用 AI agent 写代码，原生 git worktree 就够了。

参考来源

• Worktrunk 官网
• GitHub 仓库 max-sixty/worktrunk
• Koala 聊开源项目库