Worktrunk：让AI并行开发更丝滑的Git Worktree CLI

2026 年 9 月：Worktrunk 于年初发布，现已成为最受欢迎的 git worktree 管理工具。这是用心打造的产品（没有敷衍！）。如果遇到任何不便，请尽管反馈；我致力于持续让 Worktrunk 变得更好，而最大的帮助就是大家把遇到的问题说出来。

Worktrunk 是一个用于 git worktree 管理的 CLI 工具，专为并行运行 AI Agent 而设计。

Worktrunk 的三个核心命令让 worktree 变得和分支一样简单。此外，Worktrunk 还提供了大量提升日常体验的功能，以简化多并行变更的工作流程，包括自动化本地工作流的 hooks。

📚 完整文档见 worktrunk.dev 📚

背景：git worktree

像 Claude Code 和 Codex 这类 AI Agent 能够无人值守地处理更长的任务，从而可以同时管理 5-10 个甚至更多并行的 Agent。Git 原生的 worktree 特性让每个 Agent 拥有独立的工作目录，互不干扰。

但 git worktree 的用户体验很笨拙。即使是创建一个新的 worktree 这样的小任务，也需要输入三次分支名：git worktree add -b feat ../repo.feat，然后 cd ../repo.feat。

Worktrunk 让 git worktree 变得和分支一样简单

Worktree 通过分支名来定位；路径由可配置的模板计算得出。接受分支名的命令也接受该 worktree 检出所在目录的路径。

从核心命令开始

git worktree add -b feat ../repo.feat && \
cd ../repo.feat && \
claude

cd ../repo && \
git worktree remove ../repo.feat && \
git branch -d feat

根据需要再扩展到更高级的命令

Hooks — 在 create、pre-merge、post-merge 等时机运行命令

LLM commit messages — 从 diff 生成 commit 信息

Merge workflow — 一次命令完成 squash、rebase、merge 和清理

Interactive picker — 浏览 worktree 时实时预览 diff 和 log

Share build caches — 十个 worktree 共享 target/、node_modules/ 等，无需重新构建或复制（在 APFS、btrfs 和 XFS 上）

wt list --full — 每个分支的 CI 状态和 AI 生成摘要

PR checkout — wt switch pr:123 直接跳转到 PR 所在分支

每个 worktree 独立的 dev server — hash_port 模板过滤器为每个 worktree 分配独立端口

Aliases 和 per-branch 变量 — 自定义 wt <name> 命令，以及用于 hook 模板的分支作用域状态

多个并行 Agent，同样的简单命令：

安装

Homebrew（macOS & Linux）：

brew install worktrunk && wt config shell install

Shell 集成允许命令自动切换目录。

cargo：

cargo install worktrunk && wt config shell install

Windows

wt 默认使用 Windows Terminal 的命令，因此 Winget 还会将 Worktrunk 安装为 git-wt 以避免冲突：

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

或者，禁用 Windows Terminal 的别名（Settings → Apps → Advanced app settings → App execution aliases → "Terminal"/"Terminal Preview"）来直接使用 wt。

由 SignPath.io 提供免费代码签名，证书由 SignPath Foundation 颁发 — policy。

sudo pacman：

sudo pacman -S worktrunk && wt config shell install

Conda / Pixi（社区维护的 feedstock）：

conda install -c conda-forge worktrunk && wt config shell install

或者用 Pixi：pixi global install worktrunk && wt config shell install。

使用示例

为新功能创建 worktree：

$ wt switch --create feature-auth
✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth

这会创建一个新分支和 worktree，然后切换到该 worktree。完成工作后，用 wt list 查看所有 worktree：

$ wt list
  Branch        Status      HEAD±     main↕    main…±    Remote⇅  Commit    Age  Message
@ feature-auth  +   ↑      +27   -8   ↑1       +31                4bc72dc    2h  Add authenticati…
^ main              ^⇡                                    ⇡1      0e631ad    1d  Initial commit

○ Showing 2 worktrees, 1 with changes, 1 ahead, hidden: Path

@ 标记当前 worktree。+ 表示已暂存的变更，↑1 表示领先 main 一个 commit，⇡ 表示有未推送的 commit。

PR 工作流 — commit、push、创建 PR、通过 GitHub/GitLab 合并，然后清理：

wt step commit                    # commit 已暂存的变更
gh pr create                      # 或 glab mr create
wt remove                         # PR 合并后执行

本地合并 — squash、rebase 到 main、快速前进合并、清理：

$ wt merge main
◎ Generating commit message and committing changes... (2 files, +53, no squashing needed)
  Add authentication module
✓ Committed changes @ a1b2c3d
◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
  * a1b2c3d Add authentication module
   auth.rs | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
   lib.rs  |  2 ++
   2 files changed, 53 insertions(+)
✓ Merged to main (1 commit, 2 files, +53)
◎ Removing feature-auth worktree & branch in background (same commit as main, _)
○ Switched to worktree for main @ ~/repo

并行 Agent

为并行 Agent 创建多个 worktree，并在每个中启动 Agent：

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 标志在切换后运行命令；-- 后的参数会传递给该命令。配置 post-start hooks 来自动化设置（安装依赖、启动 dev server）。

了解更多

学习核心命令：wt switch、wt list、wt merge、wt remove

设置 hooks 实现自动化设置

探索 LLM commit messages、interactive picker、Claude Code 集成、CI 状态和 PR 链接

浏览 tips & patterns 菜谱：aliases、dev server、database、agent 交接等

扩展 Worktrunk — 用 hooks & aliases 自定义工作流

运行 wt --help 或 wt <command> --help 获取快速 CLI 参考

资源

Claude Code: Best practices for agentic coding — Anthropic 官方指南，包含 worktree 模式

Shipping faster with Claude Code and Git Worktrees — incident.io 的并行 Agent 工作流

Git worktree pattern discussion — Claude Code 仓库中的社区讨论

@DevOpsToolbox 的 Worktrunk 视频

git-worktree documentation — Git 官方参考文档

反馈

告诉身边的朋友 Worktrunk

提交 issue — 反馈、功能请求、任何小小的不便或表述不完善的地方，或是尚未解决 worktree 痛点

分享：X · Reddit · LinkedIn

开发

cargo test

Shell 集成测试需要 bash、zsh、fish、nushell 和 pwsh，以及 jq：

cargo test --test integration --features shell-integration-tests

📚 完整文档见 worktrunk.dev 📚