12,405 星,一个把 worktree 当分支用的 CLI
Worktrunk 卖的不是新能力,是把 git 自带的 worktree 命令变短。仓库 2025-10-17 创建,2026-11-11 核对时 12,405 星、488 fork,主语言 Rust,最近一次推送在 11-10。
它面向的场景很具体:Claude Code、Codex 这类 agent 能长时间无人值守跑任务,README 说一个人可以同时管 5 到 10 个以上。git 的 worktree 给每个 agent 一个独立目录,彼此不覆盖改动。
原生命令的问题是要把分支名打三遍。先执行 git worktree add -b feat ../repo.feat,再切目录,两步都带着同一个名字。
Worktrunk 把这一串收成 wt switch feat,目录路径由模板算出来,人只记分支名。
下面是仓库身份,全部来自 api.github.com 的仓库接口,罗列成表而不是塞进一句话。
| 字段 | 核对值 |
|---|---|
| 星标 / fork | 12,405 / 488 |
| 创建 / 最近推送 | 2025-10-17 / 2026-11-10 |
| 主语言 / 默认分支 | Rust / main |
| 许可证(API) | NOASSERTION |
| open issue / PR | 43 / 14 |
| 订阅者 / 仓库体积 | 26 / 63,238 KB |
| tag 总数 | 154 个,0.1.0 至 v0.81.0 |
| 主页 | worktrunk.dev |
README 在 2026 年 11 月的更新里写「年初发布」,仓库创建时间却是 2025-10-17。两者并不矛盾:仓库先建,公开发布另有一个时间点,引用时不宜把 created_at 当成发布日。
按分支名寻址,路径不再由人记
整套设计只有一个支点:worktree 用分支名寻址,物理路径由配置模板生成。接受分支名的命令也接受该 worktree 所在的路径,人不用记目录在哪。
README 把四个高频动作和原生 git 做了对照,这里照搬成表。注意「新建并启动 Claude」在原生 git 里是三步,Worktrunk 用 -x 把启动命令挂在切换之后。
| 任务 | Worktrunk | 原生 git |
|---|---|---|
| 切换 worktree | wt switch feat | cd ../repo.feat |
| 新建并启动 Claude | wt switch -c -x claude feat | worktree add、cd、claude 三步 |
| 清理 | wt remove | worktree remove、branch -d 两步 |
| 带状态列出 | wt list | git worktree list(只有路径) |
再往上是可选层,README 列了十项。它们共享同一个思路:把「多个 agent 同时改代码」派生出来的杂活收进 wt 的子命令,而不是让人自己写脚本串。
- hooks:创建、合并前后跑命令,可装依赖、起服务
- LLM 提交信息:按 diff 生成 commit message
- 交互式 picker:带 CI 状态与 diff、log、PR 预览
- PR 直达:
wt switch pr:123跳到对应分支 - 分端口:
hash_port给每个 worktree 一个唯一端口
其中最能省时间的是复制忽略文件,对应 wt step copy-ignored。它让十个 worktree 共用构建缓存目录 target 与 node_modules,不必重新构建。
这个能力有文件系统门槛:只在 APFS、btrfs、XFS 上成立,Windows 的 NTFS 不在名单里。
还有个前置条件容易被跳过:命令要能改变当前目录,必须装 shell 集成。安装说明里 wt config shell install 和主程序是并列的一步,不是可选项。
说三个核心命令,仓库里七成文件是测试
「三个命令」是给用户的界面,不是仓库的真实体量。拉下完整 git 树后,1,940 个条目里有 1,829 个 blob、合计 17,355,931 字节,truncated 为 false,可以放心数。
其中 tests/ 占 1,283 个文件,是全仓 blob 的 70.1%、字节数的 40.8%。src/ 只有 278 个文件。测试目录里 1,195 项是快照,全仓 .snap 文件 1,274 份、3,103,854 字节。
| 目录 / 类型 | 文件数 | 字节 | 占全部 blob |
|---|---|---|---|
| tests/ | 1,283 | 7,082,388 | 70.1% |
| src/ | 278 | 6,851,600 | 15.2% |
| .snap 快照 | 1,274 | 3,103,854 | 与 tests/ 重叠 |
| 全仓 blob | 1,829 | 17,355,931 | 100% |
.snap 与 tests/ 是包含关系,不能相加。另有一处口径:212 个 src 下的 .rs 文件共 6,795,022 字节,75 个 tests 下的 .rs 文件却有 4,036,309 字节,测试代码按体积算接近源码的六成。
源码内部也不是均匀铺开的。src/commands/ 的 124 个文件里,交互式选择器占 31 个、列表渲染占 29 个,光这两块就接近一半。
| src 子目录 | 文件数 | 字节 |
|---|---|---|
| commands/ | 124 | 2,987,598 |
| git/ | 31 | 1,274,716 |
| config/ | 37 | 768,954 |
| shell/ | 20 | 127,226 |
顺带一提,全仓 91 份 .md 文档里,docs/src 下只有 15 份。文档量相对克制,但 README 中大量段落标注了「自动生成自 docs 源文件」,改文案要改源文件,不是直接改 README。
自述数字也值得逐条对。README 开头写「three core commands」,同一份文档却在 Next steps 列出四个核心命令;实现目录 src/commands/ 下另有 124 个文件。
| 口径 | README 开头 | 同文档 Next steps |
|---|---|---|
| 核心命令 | three core commands | switch、list、merge、remove |
| 实现层 | 未提 | src/commands/ 124 个文件 |
- 「三个核心命令」:README 自述,同文档列 4 个,实现目录 124 个文件
- 「5 到 10 个并行 agent」:场景描述,仓库没有并发实测数据
- 「最流行的 worktree 管理器」:作者自述,无第三方排名可核
- 「no slop」:README 强调没有 AI 灌水,代价是 1,274 份快照
最硬的一处反差在许可证。API 的 license.spdx_id 返回 NOASSERTION,key 是 other;但 11,813 字节的 LICENSE 首行写的是 dual-licensed under MIT and Apache-2.0。
Cargo.toml 的 license 字段写 MIT OR Apache-2.0,README 徽章一致。原因不难猜:GitHub 的识别器认不出同一文件里的二选一双许可,于是给了 NOASSERTION。
任何只读 API 字段做合规扫描的工具,都会把它标成「许可未知」,而作者其实写得清清楚楚。
数据核对:以下字段均直接读取,未做二次推算。
- 身份:max-sixty/worktrunk,12,405 星 / 488 fork,Rust,main,创建 2025-10-17。
- 版本:v0.81.0 发布于 2026-10-20,18 个资产、5 个平台包;Cargo.toml 写 0.81.0 / edition 2024 / MSRV 1.98。
- 目录:完整树 truncated=false,1,940 条目 / 1,829 blob / 17,355,931 字节;tests 1,283、src 278、.snap 1,274。
- 口径:自述三个核心命令 vs 文档列 4 个;API 许可 NOASSERTION vs 文件 MIT OR Apache-2.0。
- 边界:open_issues_count 57 = 43 issue + 14 PR;未安装、未运行、未做性能实测。
核对时间 2026-11-11。
先装 shell 集成,再决定要不要上 hooks
最短路径是安装、集成、三个命令,其余都按需再加。发布页给了 18 个资产,其中 5 个是平台二进制包,覆盖 macOS 两种架构、Windows x64、Linux 两种 musl 架构。
| 渠道 | 命令 | 适用 |
|---|---|---|
| Homebrew | brew install worktrunk | macOS / Linux |
| Cargo | cargo install worktrunk | 需 Rust 1.98 起 |
| Winget | winget install max-sixty.worktrunk | Windows |
| 必做一步 | wt config shell install | 命令才能切换目录 |
Windows 有个命名坑:wt 默认是 Windows Terminal 的命令,所以 Winget 额外装成 git-wt,集成也要用这个名字,或者去系统设置里关掉终端别名。
并行 agent 的写法是每行一个任务,-x 后跟要启动的程序,-- 后面是传给它的提示词。README 给了三条并列示例:加认证、修分页 bug、补 API 测试。
- 建 worktree 并切过去:
wt switch --create feature-auth - 看所有工作区状态:
wt list - 本地合并并清理:
wt merge main - 完成后删除:
wt remove
并行开三个 agent 时,README 的写法是三行 wt switch -x claude -c <分支> -- '<提示词>',每条建一个独立 worktree 并把提示词透传进去。目录隔离由 git 保证,Worktrunk 只负责把这三行变短。
先别急着配 hooks。它是可选层,且 v0.81.0 刚改了前台 hook 的输入方式;先把三个命令跑顺,再按文档加 post-start hooks 去装依赖、起服务。
还有一个容易误判的点:wt list 默认表格里的符号是状态压缩,--full 才展开每分支的 CI 状态与 AI 摘要。第一次用不要把隐藏列当成数据缺失。
0.81 还没到 1.0,简洁的账单在升级里
这个工具最该问的不是好不好用,而是跟不跟得上。154 个 tag 从 0.1.0 排到 v0.81.0,最新一版发布说明 19,761 字符,里面出现 13 处 Breaking、挂了 92 个 PR 链接。
一版里改了 hook 的 stdin 约定、模板引擎换到 MiniJinja 3、系统配置路径每平台只认一个、Nushell 集成要求 0.113 以上。把 hooks 写进团队脚本的人,每次升级都得重新验一遍。
贡献者结构也值得看。88 位贡献者合计 5,420 次提交,作者 max-sixty 一人 4,132 次,占 76.2%;机器人账号 1,169 次,占 21.6%;前三名合占 97.5%。
- 作者本人:4,132 次提交,76.2%
- 机器人账号:1,169 次,21.6%
- 前三名合计:97.5%,其余 85 位分摊不到 2.5%
- 定位反差:为「并行」设计的工具,维护却是单点加自动化
这不是缺陷,个人项目大多如此;但要把它写进团队流程,就得接受作者一人的节奏决定你的升级节奏。README 那句「5 到 10 个并行 agent」同样是场景假设,仓库没有给出并发规模或冲突率的实测。
许可证那处偏差还连着一个现实问题:企业合规扫描若按 API 字段走,这个 MIT OR Apache-2.0 的仓库会被归入「许可未知」而卡住。作者选择双许可没错,只是机器没读懂。用之前最好手动确认一遍 LICENSE 文件,别让扫描器替你下结论。
再算一笔账:154 个 tag 摊在 2025-10-17 至今的约 13 个月里,平均每月十来个版本。星标和推送都很热,但 热度是别人的,升级成本是自己的。
还有那个 NOASSERTION。它提醒一件事:机器读到的字段和人读到的文件未必是同一份事实。把 worktree 收成三个命令,成本没有消失,只是从命令行搬到了 1,274 份快照和 13 处 Breaking 里。
所以我的判断是:单人同时跑三五个 agent,它值得装;要嵌进多人共用的 CI 或脚本,先锁版本、把 Breaking 清单当发布说明读,别把「简洁」当成「稳定」。
去看原始仓库
max-sixty/worktrunk:为并行 AI agent 工作流设计的 Git worktree 管理 CLI,Rust 编写,MIT OR Apache-2.0 双许可。
前往 GitHub