worktrunk

一条命令给每个 AI 代理开独立工作区，并行写码不打架

Worktrunk 是一个用 Rust 编写的 Git worktree 管理命令行工具，专为并行运行多个 AI 编码代理（如 Claude Code、Codex）的工作流而设计。传统上，多个 AI 代理同时改代码时，如果共用同一个工作目录，会出现文件冲突、分支互相污染、上下文混乱等问题。Worktrunk 通过封装 Git worktree 机制，让每个代理拥有独立的工作目录和分支，彼此隔离又共享同一个仓库历史，从而安全地并行开发。它的核心能力包括：快速创建、切换、列出和清理 worktree；与 AI 代理工具链集成；用简洁的命令替代繁琐的原生 git worktree 操作；并针对代理场景优化了命名和生命周期管理。对于需要同时跑多个编码代理、做多分支实验或代码评审的开发者来说，它把原本容易出错的手工操作变成了可重复的流程。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 8282

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类自动化工作流

开发团队max-sixty

所属国家

官网地址https://worktrunk.dev

GitHubhttps://github.com/max-sixty/worktrunk

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Rust

技术栈/模型agents,claude-code,codex,developer-tools,git,worktrees

GitHub 星标★ 8282

30天Star增速

HF 下载量

上线时间2025-10-17 00:00:00

最近更新2026-09-21 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

已安装 git（Worktrunk 封装 git worktree）
macOS/Linux：Homebrew 或 Rust Cargo 工具链
Windows：Winget（会额外以 git-wt 名称安装，避免与终端 wt 冲突）
可选：Claude Code 等 AI 代理 CLI，用于 -x 启动代理
可选：gh 或 glab CLI，用于 PR/MR 工作流

安装与启动步骤

1安装 Worktrunk

macOS/Linux 用 Homebrew；也可用 cargo install worktrunk。Windows 用 winget，Arch 用 pacman，Conda/Pixi 亦可用。
```
brew install worktrunk
```
2安装 shell 集成

shell 集成让命令能够切换目录，安装后必须执行一次。Windows 装完用 git-wt config shell install。
```
wt config shell install
```
3创建并切换 worktree

为新功能创建独立分支与工作目录并切换过去，路径按可配置模板自动计算，无需手写路径。
```
wt switch --create feature-auth
```
4查看所有 worktree

列出各 worktree 的分支、改动与领先/落后状态，@ 标记当前所在 worktree。
```
wt list
```
5并行启动多个代理

-x 在切换后执行命令，-- 之后的参数传给该命令，可为每个功能开一个代理互不干扰。
```
wt switch -x claude -c feature-a -- 'Add user authentication'
wt switch -x claude -c feature-b -- 'Fix the pagination bug'
```
6合并或清理 worktree

本地合并用 wt merge main（压缩、变基、快进合并、清理一条龙）；PR 流程则推分支建 PR，合并后 wt remove。
```
wt merge main
```

如何确认成功

执行 wt list，能看到 worktree 列表且当前 worktree 前有 @ 标记，说明安装与 shell 集成均正常。

常见问题

Q：Windows 上 wt 命令和终端冲突怎么办？

A：Winget 会把 Worktrunk 装成 git-wt，直接用 git-wt 即可；或在设置→应用→高级应用设置→应用执行别名中禁用 Terminal 别名，就能用 wt。

Q：为什么安装后要跑 wt config shell install？

A：只有安装 shell 集成后，命令才能改变当前目录，wt switch 才能自动切到对应 worktree。

Q：怎么运行项目测试？

A：在源码目录执行 cargo test；shell 集成测试需额外命令，并依赖 bash、zsh、fish、nushell、pwsh 和 jq。

Q：-x 后面的参数怎么传给被调用的命令？

A：放在 -- 之后，例如 wt switch -x claude -c feature-a -- 'Add user authentication'。

注意事项

Worktrunk 按分支名寻址 worktree，路径由可配置模板生成，传入分支名或该 worktree 路径均可。
PR 工作流：wt step commit 提交、gh pr create 建 PR，合并后再执行 wt remove 清理。
可用 hooks 自动化创建、合并前后的本地流程，并支持 APFS/btrfs/XFS 上的 build 缓存共享。
完整文档见官网 worktrunk.dev。

核心亮点

用 Rust 实现，启动和操作速度快，适合高频调用
把原生 git worktree 的繁琐命令封装成简洁 CLI，降低并行代理的使用门槛
明确面向 Claude Code、Codex 等 AI 代理场景，命名和生命周期管理贴合代理工作流

不足之处

功能聚焦在 worktree 管理，不涉及代理编排、任务调度等更上层能力
相对年轻，文档和社区生态仍在成长中

适用场景

同时运行多个 AI 编码代理，各自在独立分支上改代码
为代码评审或功能实验快速创建隔离的工作目录
在同一个仓库里并行开发多个互不干扰的特性分支

替代项目

git-worktree（Git 原生）、gwq

项目介绍

worktrunk 是自动化工作流领域的开源项目，由 max-sixty 开发，2025 年首次发布。

在全站 12,909 个收录项目中，它的 GitHub 星标数（8,282）位列前 6%，在自动化工作流分类的 499 个项目里位列前 12%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-21。

它主要面向的使用场景是：同时运行多个AI编码代理，各自在独立分支上改代码。同类可对比的替代方案包括 git-worktree（Git 原生）、gwq。

上一篇：agent-slack

下一篇：Product-Manager-Skills