Worktrunk：给 git worktree 套层壳，并行跑多个 AI agent 不再互相踩文件

同时开五六个 Claude Code 或 Codex 干活，最先撞上的问题是：它们都在同一个目录里改文件，互相踩。Git 自带的 worktree 就是为这个准备的，每个任务一个独立工作目录，共用同一份仓库历史。但原生命令用起来很啰嗦，Worktrunk 就是给它包了一层顺手的壳。作者自己的说法是，它已经是目前最受欢迎的 git worktree 管理工具，今天一天涨了 50 多颗星，这类"多 agent 并行"的需求显然在变多。

它解决什么问题

原生 worktree 开一个新分支要打三遍分支名：git worktree add -b feat ../repo.feat，再 cd ../repo.feat。收尾还得手动删目录、删分支。

Worktrunk 的思路是让 worktree 像分支一样用：按分支名寻址，路径由模板自动算出来，不用自己拼。

要做的事	Worktrunk	原生 git
切换	wt switch feat	cd ../repo.feat
新建并启动 Claude	wt switch -c -x claude feat	git worktree add -b feat ../repo.feat && cd ../repo.feat && claude
清理	wt remove	git worktree remove ../repo.feat && git branch -d feat
列表带状态	wt list	git worktree list（只有路径）

核心功能

三个基础命令之外，有几项是真正在多 agent 场景下省事的：

• Hooks：在创建、合并前、合并后等节点跑自定义命令，比如新建 worktree 后自动装依赖
• 共享构建缓存：wt step copy-ignored 让十个 worktree 共用 target/、node_modules/ 之类的目录，不用每个重新构建或复制（需要 APFS、btrfs 或 XFS 这类支持写时复制的文件系统）
• 一条命令合并：squash、rebase、合并、清理一次做完
• LLM 生成提交信息：根据 diff 生成 commit message
• wt list --full：每个分支带 CI 状态和 AI 生成的摘要，一眼看出哪个 agent 干到哪了
• 直接切到 PR：wt switch pr:123 跳到某个 PR 对应的分支
• 每个 worktree 一个开发端口：模板里有 hash_port 过滤器，给每个 worktree 算出固定且不冲突的端口，多个 dev server 同时跑不打架
• 交互式选择器：流式显示 CI 状态，预览 diff、日志、PR 和评论
• 别名和按分支保存的变量：可以自定义 wt <名字> 命令

怎么装

macOS / Linux：

brew install worktrunk && wt config shell install

或者用 Cargo：

cargo install worktrunk && wt config shell install

Arch Linux 有 pacman -S worktrunk，conda 也有社区打的包。

Windows 用户要注意一个坑：wt 这个名字和 Windows Terminal 的命令冲突，所以 Winget 版额外装成了 git-wt：

winget install max-sixty.worktrunk
git-wt config shell install

也可以在系统设置里关掉 Windows Terminal 的应用执行别名，直接用 wt。

wt config shell install 这一步不能省，它装的是 shell 集成，wt switch 要靠它才能真的帮你切换目录。

适合谁，值得注意的地方

• 平时同时开多个 Claude Code、Codex 会话的人，这个工具基本是为你写的
• 即使不用 AI agent，经常需要在多个分支间来回切、不想 stash 的人，也能用上
• 共享构建缓存依赖文件系统的写时复制能力，ext4 之类的老文件系统享受不到
• 项目还在快速迭代，最新版 v0.80.0（2026-09-27 发布），版本号还没到 1.0，命令细节可能继续变
• 许可证是 MIT 或 Apache-2.0 二选一

项目信息

• 语言：Rust
• License：MIT OR Apache-2.0
• Star：截至 2026-10-01 约 8,600
• GitHub：https://github.com/max-sixty/worktrunk
• 文档：https://worktrunk.dev

---

原文发布于 SunAI 论坛。文中版本、Star 数及相对时间均以原帖发布时为准。