Worktrunk

2026年3月：Worktrunk于年初发布，并迅速成为最受欢迎的 Git 工作树管理工具。它以热爱打造而成（绝不含糊！）。如果您遇到任何问题，请随时告知我；我正全力以赴让 Worktrunk 更加出色，而您反馈的问题正是对我最大的帮助。

Worktrunk 是一款用于 Git 工作树管理的命令行工具，专为并行运行 AI 代理而设计。

Worktrunk 的三个核心命令让工作树的操作如同分支一样简单。此外，Worktrunk 还提供了一系列提升开发体验的功能，以简化对多个并行更改的处理，包括用于自动化本地工作流的钩子。

这样一来，扩展 AI 代理的数量就变得轻而易举。以下是一个快速演示：

📚 完整文档请访问 worktrunk.dev 📚

背景：Git 工作树

像 Claude Code 和 Codex 这样的 AI 代理能够无需监督地处理较长的任务，因此可以同时管理 5 到 10 个甚至更多的代理。Git 原生的工作树功能为每个代理提供了独立的工作目录，从而避免了彼此之间的变更相互干扰。

然而，Git 工作树的用户体验并不友好。即使只是启动一个新的工作树这样的小任务，也需要三次输入分支名称：git worktree add -b feat ../repo.feat，然后 cd ../repo.feat。

Worktrunk 让 Git 工作树的操作如同分支一样简单

工作树通过分支名称来标识；路径则根据可配置的模板自动生成。

从核心命令开始

核心命令：

wt switch feat

cd ../repo.feat

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

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

工作流自动化：

• 钩子 — 在创建、合并前、合并后等阶段运行命令
• LLM 提交信息 — 根据差异生成提交信息
• 合并工作流 — 可以在一条命令中完成压缩、变基、合并和清理
• 交互式选择器 — 通过实时差异和日志预览浏览工作树
• 复制构建缓存 — 通过在工作树之间共享 target/、node_modules/ 等内容，避免冷启动
• wt list --full — 按分支显示 CI 状态 和 AI 生成的摘要
• PR 检出 — 使用 wt switch pr:123 直接跳转到 PR 的分支
• 每个工作树的开发服务器 — 通过 hash_port 模板过滤器为每个工作树分配唯一的端口
• …以及 更多功能

下面是一个包含一些高级功能的演示：

安装

Homebrew（macOS 和 Linux）：

$ brew install worktrunk && wt config shell install

启用 Shell 集成后，命令可以直接切换目录。

Cargo：

$ cargo install worktrunk && wt config shell install

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

Arch Linux：

$ sudo pacman -S worktrunk && wt config shell install

快速入门

为新功能创建一个工作树：

$ wt switch --create feature-auth
✓ 从 main 分支创建了 feature-auth 分支，并在 repo.feature-auth 上设置了工作树

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

$ wt list
  分支        状态        HEAD±    main↕  远程⇅  提交    年龄   信息
@ feature-auth  +   ↑      +27   -8   ↑1               4bc72dc9  2h    添加认证模块
^ main              ^⇡                         ⇡1      0e631add  1d    初始提交

○ 显示 2 个工作树，其中 1 个有更改，1 个领先，1 列已隐藏

@ 标记当前的工作树。+ 表示暂存的更改，↑1 表示比 main 分支领先 1 次提交，⇡ 表示未推送的提交。

完成后，可以选择以下两种方式之一：

PR 工作流 — 提交、推送、打开 PR、通过 GitHub/GitLab 合并，然后清理：

$ wt step commit                    # 提交暂存的更改
$ gh pr create                      # 或 glab mr create
$ wt remove                         # 在 PR 合并后

本地合并 — 压缩提交、变基到 main 分支、快进合并、清理：

$ wt merge main
◎ 生成提交信息并提交更改... (2 个文件，+53，无需压缩)
  添加认证模块
✓ 已提交更改 @ a1b2c3d
◎ 将 1 次提交合并到 main 分支 @ a1b2c3d（无需变基）
  * a1b2c3d 添加认证模块
   auth.rs | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
   lib.rs  |  2 ++
   2 个文件改变了，新增 53 行
✓ 已合并到 main 分支（1 次提交，2 个文件，+53）
◎ 在后台移除 feature-auth 工作树和分支（与 main 分支相同提交，_）
○ 已切换到 main 分支的工作树 @ repo

对于并行代理，可以创建多个工作树，并在每个工作树中启动一个代理：

$ wt switch -x claude -c feature-a -- '添加用户认证'
$ wt switch -x claude -c feature-b -- '修复分页 bug'
$ wt switch -x claude -c feature-c -- '为 API 编写测试'

-x 标志会在切换后运行命令；-- 之后的参数会传递给该命令。配置 启动后钩子 来自动化设置（安装依赖、启动开发服务器）。

下一步

• 学习核心命令：wt switch、wt list、wt merge、wt remove
• 设置 项目钩子 以实现自动化设置
• 探索 LLM 提交信息、交互式选择器、Claude Code 集成、CI 状态和 PR 链接
• 浏览 技巧与模式 获取配方：别名、开发服务器、数据库、代理交接等
• 运行 wt --help 或 wt <命令> --help 以获取快速 CLI 参考

更多阅读

• Claude Code：代理式编码的最佳实践 — Anthropic 的官方指南，包括工作树模式
• 使用 Claude Code 和 Git 工作树更快地交付 — incident.io 的并行代理工作流程
• Git 工作树模式讨论 — Claude Code 仓库中的社区讨论
• @DevOpsToolbox 关于 Worktrunk 的视频
• git-worktree 文档 — 官方 git 参考

贡献

• ⭐ 给这个仓库加星
• 告诉朋友关于 Worktrunk 的事情
• [提交一个问题](https://github.com/max-sixty/worktrunk/issues/new?title=&body=%23%23%20Description%0A%0A%3C!--%20描述错误或功能请求 --%3E%0A%0A%23%23%20Context%0A%0A%3C!--%20任何相关背景：你的工作流程、你试图做的事情等 --%3E) — 反馈、功能请求，甚至一个小摩擦或不完美的用户提示，或者 [尚未解决的工作树痛点](https://github.com/max-sixty/worktrunk/issues/new?title=Worktree%20friction%3A%20&body=%23%23%20The%20friction%0A%0A%3C!--%20什么与工作树相关的任务仍然让人感到痛苦？ --%3E%0A%0A%23%23%20Current%20workaround%0A%0A%3C!--%20你今天是如何处理这个问题的？ --%3E%0A%0A%23%23%20Ideal%20solution%0A%0A%3C!--%20什么会让这件事更容易呢？ --%3E)
• 分享：X · Reddit · LinkedIn

📚 完整文档请访问 worktrunk.dev 📚

星标历史

Worktrunk 快速上手指南

Worktrunk 是一个专为并行运行 AI 智能体（如 Claude Code、Codex）设计的 Git Worktree 管理 CLI 工具。它将复杂的 Git Worktree 操作简化为类似分支管理的简单命令，极大提升了多任务并行开发的效率。

环境准备

• 操作系统：macOS、Linux 或 Windows
• 前置依赖：
  • 已安装 git (建议版本 2.5+)
  • 已安装 curl 或 wget (用于部分安装方式)
  • (可选) AI 编码助手，如 claude (Claude Code) 或其他 LLM CLI 工具
• 网络要求：需能访问 GitHub 及对应包管理器源。国内用户若遇到连接问题，建议配置相应的网络代理或使用镜像源。

安装步骤

根据你的系统选择以下一种安装方式。安装后务必执行 shell 集成命令，以支持自动切换目录功能。

macOS & Linux (推荐 Homebrew)

brew install worktrunk && wt config shell install

Rust 用户 (Cargo)

cargo install worktrunk && wt config shell install

Arch Linux

sudo pacman -S worktrunk && wt config shell install

Windows

Windows Terminal 默认占用 wt 命令，推荐使用 winget 安装（命令别名为 git-wt），或手动关闭 Windows Terminal 的别名设置。

方式一：使用 Winget (保留 git-wt 命令)

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

方式二：直接使用 wt 命令 需在 Windows 设置中禁用 "Windows Terminal" 的应用执行别名 (设置 → 隐私和安全 → 对于开发人员 → 应用执行别名)，然后运行：

winget install max-sixty.worktrunk
wt config shell install

基本使用

1. 创建并切换到新工作区

创建一个名为 feature-auth 的新分支和工作区，并自动切换进去：

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

2. 查看工作状态

列出所有工作区及其状态（当前所在标记为 @，包含未提交变更标记为 +）：

$ wt list
  Branch        Status        HEAD±    main↕  Remote⇅  Commit    Age   Message
@ feature-auth  +   ↑      +27   -8   ↑1               4bc72dc9  2h    Add authentication module
^ main              ^⇡                         ⇡1      0e631add  1d    Initial commit

○ Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden

3. 并行启动 AI 智能体

这是 Worktrunk 的核心场景。你可以一键创建多个工作区并分别启动 AI 智能体进行并行开发：

# 创建工作区 A 并启动 Claude 处理认证功能
$ wt switch -x claude -c feature-a -- 'Add user authentication'

# 创建工作区 B 并启动 Claude 修复分页 Bug
$ wt switch -x claude -c feature-b -- 'Fix the pagination bug'

# 创建工作区 C 并启动 Claude 编写测试
$ wt switch -x claude -c feature-c -- 'Write tests for the API'

注：-x 表示切换后执行命令，-c 表示创建新分支，-- 后的内容传递给 AI 工具。

4. 合并与清理

完成开发后，可以使用简化的命令合并代码并清理工作区。

本地合并模式（变基 + 快进合并 + 清理）：

$ wt merge main
◎ Generating commit message and committing changes...
✓ Committed changes @ a1b2c3d
◎ Merging 1 commit to main @ a1b2c3d
✓ Merged to main (1 commit, 2 files, +53)
◎ Removing feature-auth worktree & branch in background
○ Switched to worktree for main @ repo

PR 流程模式：

$ wt step commit       # 提交暂存更改
$ gh pr create         # 创建 Pull Request (需安装 gh)
$ wt remove            # PR 合并后清理当前工作区