当5个AI编程Agent同时跑任务，Git开始报警：Worktrunk用一条命令解决了并行隔离问题

当你的 AI 编程 Agent 开始并行跑任务，Git 就是第一个撞上的墙。

Claude Code 跑 feat-auth，Codex 跑 feat-api，两个 Agent 同时 checkout main 分支，改同一个文件——轻则覆盖，重则丢失。一个常见的解法是开两个终端窗口、两个目录、两次 git clone。但当你需要跑 5 个、10 个 Agent 并行，这个方案就变成了管理噩梦。

Git 本身其实有解决方案：worktree。它允许同一个仓库在不同目录同时 checkout 不同分支，彼此隔离、共享历史。问题在于原始 UX 极其繁琐——创建一个新 worktree，要打三遍分支名：

git worktree add -b feat ../repo.feat
cd ../repo.feat
# 才开始真正工作

Worktrunk（https://github.com/max-sixty/worktrunk）把这个流程压缩成一条命令。它是 Rust 写的 CLI，目标用户就是那些同时跑多个 AI 编程 Agent 的开发者。

三个核心命令，解决 90% 场景

Worktrunk 的设计哲学是：worktree 应该和 branch 一样简单。它只有三个核心命令：

# 创建并切换到新 worktree（一条命令替代上面三行）
wt switch -c feat-auth

# 在新 worktree 里直接启动 Claude Code
wt switch -c -x claude feat-auth -- 'Add user authentication module'

# 查看所有 worktree 状态
wt list

# 清理 worktree 和对应分支
wt remove feat-auth

wt list 的输出很实用：显示每个分支的 dirty 状态、ahead/behind 远程的 commits 数量、最后提交时间和消息。当前分支用 @ 标记，一眼就能看清全局。

v0.75.0（2026-08-27）刚更新了 wt switch 的交互选择器，本地变更、已提交、分阶段、未暂存、未跟踪全部合并在一个 unified diff 视图中，Tab 跳过空视图，Alt+数字直接跳转。

适合谁

适合： 正在用 Claude Code、Codex 或类似 Agent 同时开发多个功能的个人开发者或小团队。比如你同时修 bug、做重构、上新功能——每个任务开一个 worktree，Agent 之间完全隔离，不会互相踩踏。Worktrunk 官方甚至鼓励这种用法，wt switch -x claude 可以一条命令创建 worktree 并直接在里面启动 Claude Code。

不适合： 单 Agent 单任务的常规开发流程，这时候 git branch + PR 就是最佳实践，不需要引入额外工具。另外 Windows 支持相对较弱，虽然有 Winget 和 Arch Linux 支持，但生产环境建议用 macOS/Linux。

几个值得关注的技术细节

Build cache 复用：如果你用 Node.js/Rust 等有编译缓存的项目，可以配置 copy = ["node_modules", "target/", ".next"]，让新建的 worktree 直接复用已有缓存，避免每次重新安装依赖。官方称这能显著缩短冷启动时间。

Hooks 自动化：通过 .worktrunk.toml 配置 on_create、pre_merge、post_merge 等钩子，自动化 npm install、测试、push 等流程。这是让 Agent 工作流少操心的关键。

LLM 生成 commit message：wt merge 命令会自动根据 diff 生成 commit message，不用 Agent 自己写或者手动补。

PR checkout：wt switch pr:123 可以直接跳转到某个 PR 对应的分支，结合 GitHub CLI 使用体验流畅。

真实限制

Worktrunk 本质是 Git worktree 的包装器，不改写 Git 历史，不支持跨仓库的 worktree（这是 Git 本身的限制）。如果你的仓库用了 shallow clone（--depth=1），worktree 功能可能受限制。另外 44 个 open issues 中有相当一部分是 Windows 特定问题，说明社区还在完善 Windows 体验。

可执行的下一步

如果你现在就在跑多个 AI Agent 并行开发，先确认你的仓库没有用 shallow clone。然后：

# macOS / Linux
brew install worktrunk && wt config shell install

# Rust 生态
cargo install worktrunk && wt config shell install

# 创建第一个并行 worktree
cd ~/your-repo
wt switch -c -x claude feature-a -- '实现功能 A'
# 再开一个终端
wt switch -c -x claude feature-b -- '实现功能 B'

作者 max-sixty 同时是 PRQL（10k stars）和 Xarray（4k stars）的作者，项目背书有一定可信度。v0.75.0 刚发布，还在快速迭代，Windows 用户和在意稳定性的团队可以先观望一两个版本。

GitHub：https://github.com/max-sixty/worktrunk
文档：https://worktrunk.dev