Claude Code、Codex 这类编程 Agent 如今能独立跑完越来越长的任务，同时开 5 到 10 个 Agent 并行干活已经是常态。问题是：它们不能共用同一个工作目录，否则改着改着就互相踩了对方的修改。
Git 原生就有一个解法：worktree，给每个分支单独开一个工作目录。但原生命令实在难用——开一个新 worktree 要把分支名敲三遍：git worktree add -b feat ../repo.feat，再 cd 过去。Worktrunk 就是来解决这个问题的：一个用 Rust 写的 Git worktree 管理 CLI，目标是让 worktree 像分支一样好用。
项目由 max-sixty 开发，2025 年 10 月发布，采用 MIT 或 Apache-2.0 双协议开源，如今已有 1 万多星，11 月 4 日登上 GitHub 日榜。作者在 README 里写道，它自年初发布以来迅速成为最受欢迎的 Git worktree 管理工具。
三条核心命令
Worktrunk 的核心就三条命令，worktree 按分支名寻址，路径由可配置的模板自动算出：
| 任务 | Worktrunk | 原生 Git |
|---|---|---|
| 切换 worktree | 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 |
cd ../repo && git worktree remove ../repo.feat && git branch -d feat |
| 带状态的列表 | wt list |
git worktree list（只有路径） |
wt list 不只是列目录，还会显示每个分支的改动状态、领先主分支几个提交、有没有未推送的提交，以及最近一次提交的信息，一眼就能看出 10 个并行任务各跑到哪一步。
不只是省敲键盘：给并行工作流准备的自动化
- Hooks：在创建、合并前后等时机自动跑命令，比如新建 worktree 后自动装依赖、起开发服务器。
- LLM 提交信息：根据 diff 自动生成提交信息，
wt step commit一条命令走完提交流程。 - 一键合并：
wt merge main把压缩、变基、合并、清理 worktree 全包了。 - 交互式选择器：浏览 worktree 时实时看到 CI 状态、diff、日志、PR 与评论预览。
- 共享构建缓存：十个 worktree 共用
target/、node_modules/，不用重复构建或复制（APFS、btrfs、XFS 上用写时复制实现，Mac 用户直接受益）。 wt list --full：每个分支附带 CI 状态和 AI 生成的摘要。- PR 检出：
wt switch pr:123直接跳到某个 PR 的分支。 - 每个 worktree 一个开发端口：
hash_port模板过滤器给每个 worktree 分配唯一端口，互不冲突。
让多个 Agent 并行开工
并行跑 Agent 时，一行命令开一个任务，各自进各自的 worktree：
wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
wt switch -x claude -c feature-c -- 'Write tests for the API'-x 表示切换后执行后面的命令，-- 之后的内容传给 Agent。配合 post-start hook，还能让每个 worktree 自动完成环境准备。
安装
Homebrew（macOS 与 Linux）：
brew install worktrunk && wt config shell installCargo：
cargo install worktrunk && wt config shell installWindows 用 winget install max-sixty.worktrunk（会装成 git-wt 以避开 Windows Terminal 的 wt 命令冲突），Arch Linux 可用 pacman，Conda 用户走 conda-forge。注意 wt config shell install 这一步不能省：shell 集成是 wt switch 能帮你切换目录的关键。
适合谁
如果你已经在用 Claude Code 或 Codex 做开发，而且经常同时开几个任务——修 bug、加功能、写测试分头推进——Worktrunk 能把原来那套容易出错的手工 worktree 操作收成三条命令。就算不用 AI Agent，它也是一个顺手的 worktree 管理器：wt list 的状态总览和一键合并，单独拿出来也值回安装成本。完整文档在 worktrunk.dev。
同样玩转 AI 编程 Agent 的工具还有：Vercel 开源的 agent-desktop，让 AI Agent 直接读懂并操作桌面应用；claude-mem 让 Claude Code 记住上个会话的事；以及把 Claude Code 变成一家游戏工作室的 Claude Code Game Studios，49 个 Agent 加 74 个 Skill。
转自 GitHub 作者 max-sixty 的文章《Worktrunk》，原文链接：https://github.com/max-sixty/worktrunk
暂无评论内容