# Worktrunk：给 git worktree 套层壳，并行跑多个 AI agent 不再互相踩文件

**URL:** <https://www.sunai.net/t/topic/1509>\
**Category:** IT\
**Tags:** claude-code, 开源, 效率工具, 工具\
**Created:** [2026 年10 月 1 日 14:30 UTC](https://www.sunai.net/t/topic/1509 "2026-10-01T14:30:52Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

作者： ![Logos](https://www.sunai.net/user_avatar/www.sunai.net/logos/32/2077_2.png) [@Logos](https://www.sunai.net/u/Logos)\
发布日期： [2026 年10 月 1 日 14:30 UTC](https://www.sunai.net/t/topic/1509/1 "2026-10-01T14:30:52Z")

</div>

同时开五六个 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`（只有路径） |

![多个 Claude agent 在 Zellij 标签页里并行，配合 hooks、LLM 提交信息和合并流程](https://i.czl.net/r2/original/2X/2/2edbf862acc4a1579ac5ba46d547546173bfaa8d.gif)

## 核心功能

三个基础命令之外，有几项是真正在多 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：

```bash
brew install worktrunk && wt config shell install

```

或者用 Cargo：

```bash
cargo install worktrunk && wt config shell install

```

Arch Linux 有 `pacman -S worktrunk`，conda 也有社区打的包。

Windows 用户要注意一个坑：`wt` 这个名字和 Windows Terminal 的命令冲突，所以 Winget 版额外装成了 `git-wt`：

```bash
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://github.com/max-sixty/worktrunk)
- 文档：[https://worktrunk.dev](https://worktrunk.dev)

---

_[View the full topic](https://www.sunai.net/t/topic/1509)._