同时开五六个 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：GitHub - max-sixty/worktrunk: Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows · GitHub
- 文档：https://worktrunk.dev