Worktrunk：简化 Git worktree 与并行 Agent 开发流程
一分钟看懂
Worktrunk 是一个 Git worktree 管理命令行工具。它用分支名自动计算目录，把创建、切换、查看、合并和清理 worktree 变成较短命令，特别适合让多个编程 Agent 在相互隔离的工作目录中并行修改同一仓库。
你可以用它做什么
- 为新功能创建分支和 worktree，并立即在其中启动 Claude Code 等 Agent。
- 列出所有 worktree 的改动、领先提交、远端状态和 CI 情况。
- 通过一个流程完成提交、变基或合并，再安全清理分支与工作目录。
- 用钩子自动安装依赖、启动开发服务或执行合并前后任务。
- 为每个 worktree 分配独立端口，并在支持的文件系统上共享构建缓存。
主要能力
- 核心命令覆盖
switch、list、merge、remove和分步工作流。 - 支持交互式选择、PR/MR 检出、LLM 提交信息和可配置路径模板。
- 可通过钩子、别名与分支变量扩展团队工作流。
- 提供 Homebrew、Cargo、Winget、Arch Linux 和 Conda/Pixi 等安装方式。
适合哪些人
适合熟悉 Git 分支、需要同时推进多个任务的开发者，以及管理多个本地编程 Agent 的团队。若项目规模小、从不并行开发，原生分支或单个 worktree 可能已经足够。
怎么开始使用
macOS 和 Linux 可用 Homebrew 安装，Windows 可用 Winget，Rust 用户也可通过 Cargo。安装后运行 wt config shell install 开启目录切换集成；在仓库里用 wt switch --create feature-name 建立工作树，用 wt list 检查状态，再按 PR 或本地合并流程完成工作。
使用前需要知道
合并、删除 worktree 和自动钩子会改变 Git 状态或执行外部命令，正式使用前应检查未提交改动、钩子内容和目标分支。并行 Agent 仍可能在远端分支、共享服务、数据库或端口层面互相影响，worktree 只隔离文件工作目录。
Windows 中 wt 可能与 Windows Terminal 命令冲突，Winget 同时提供 git-wt 名称。项目采用 MIT 或 Apache-2.0 双许可证，用户可择一使用。