max-sixty/worktrunk

TL;DR

Worktrunk 是一个用 Rust 编写的 CLI，旨在将 Git worktree 的管理体验简化到与分支无异。它针对并行运行多个 AI Agent（如 Claude Code、Codex）的场景进行了深度优化，解决了原生 Git 命令在并发编码场景下繁琐且易错的痛点。

它解决什么问题

随着 AI Coding Agent（如 Claude Code、Codex）能力的提升，开发者可以同时并行运行 5-10+ 个 Agent 处理不同的任务。Git 原生的 worktree 功能虽然允许为每个 Agent 提供独立的工作目录，但其 UX 极其糟糕：创建一个新的 worktree 需要重复输入分支名三次（git worktree add -b feat ../repo.feat），且缺乏直观的列表和状态查看工具。在高频切换、快速迭代的 Agent 工作流中，这种摩擦会严重降低效率。

核心做法

Worktrunk 通过三个核心命令（switch, list, remove/merge）重构了交互逻辑： 1. 路径模板化：Worktree 的路径由分支名通过可配置的模板自动生成，用户只需关注 Branch Name。 2. 状态可视化：wt list 提供类似 git status 的丰富信息，包括提交差异、远程同步状态等。 3. Agent 集成：支持 -x 参数在切换 worktree 后直接执行命令（如启动 Agent），并支持 Hooks 自动化环境配置。 4. 高级功能：内置 LLM Commit Message 生成、PR Checkout (wt switch pr:123)、以及针对特定文件系统（APFS, btrfs）的构建缓存共享机制。

作者

项目由 max-sixty (Max Sixty) 独立开发。从 README 和元数据来看，作者专注于开发者工具领域，且该项目在发布后迅速获得了极高的社区关注度。目前没有更多关于其职业背景的详细公开信息。

社区反应

截至数据提取时，该项目已获得 7,240 Stars 和 256 Forks。考虑到其创建于 2025 年（根据元数据中的时间戳，这似乎是一个未来视角的模拟或特定上下文设定），其增长曲线极为陡峭。Open Issues 为 39，表明项目处于活跃迭代期且用户反馈集中。作为 Rust 生态中针对 Git 工作流的新兴工具，它迅速成为了该细分领域最受欢迎的选择。

怎么上手

依赖与安装： - macOS/Linux (Homebrew): brew install worktrunk && wt config shell install - Rust/Cargo: cargo install worktrunk && wt config shell install - Windows (Winget): winget install max-sixty.worktrunk（注意别名冲突，默认安装为 git-wt

最小复现步骤： 1. 进入一个 Git 仓库。 2. wt switch -c feature-auth：自动创建分支和 worktree 并切换。 3. wt list：查看当前所有 worktree 的状态。 4. wt merge main：完成工作后，合并并清理 worktree。

争议与局限

文件系统依赖：其“共享构建缓存”功能依赖于 APFS、btrfs 或 XFS 等支持特定硬链接/克隆特性的文件系统，在 ext4 或其他系统上可能无法使用此高级特性。
Windows 兼容性：虽然支持 Windows，但由于 wt 是 Windows Terminal 的默认命令别名，用户需要额外配置或使用 git-wt 前缀，这在跨平台脚本中可能带来兼容性问题。
LLM 依赖：内置的 LLM Commit Message 功能需要配置外部 AI API，增加了使用门槛和潜在的成本。
推断：作为 CLI 工具，其性能优势主要体现在启动速度和并发处理能力上，但对于极大规模仓库（GB 级代码库），其索引速度仍需实测验证。