Repolode
max-sixty

max-sixty/worktrunk

一个用 Rust 编写的 Git worktree 管理 CLI,可按分支名切换和管理工作树,适合并行运行多个 AI 编程代理。

Star
9,341
Fork
333
未关闭 Issue
67
最近提交
3小时前

这是什么?

Worktrunk 是一个管理 Git worktree 的命令行工具。你不必再手动处理路径和原始 git 命令,而是直接用分支名操作工作树:`wt switch` 切换,`wt list` 查看每个工作树的状态,`wt remove` 连同分支一起清理。为新分支创建工作树只需一条命令,目录路径由可配置的模板生成。

它主要面向同时运行多个 AI 编程代理(如 Claude Code、Codex)的场景。每个代理在独立的工作树中工作,修改互不干扰。钩子(hooks)可在创建工作树或合并等事件时自动执行命令;`wt step copy-ignored` 可在支持的文件系统上让多个工作树共享 `target/`、`node_modules/` 等构建缓存;`wt switch pr:123` 可直接检出某个 Pull Request 的分支。

此外,`wt merge` 支持本地合并流程,包括压缩提交、变基、快进合并到主分支,并在完成后清理工作树。`wt list --full` 还可显示 CI 状态,并可选择由 LLM 生成提交信息。安装方式包括 Homebrew、Cargo、Winget、Arch Linux 软件包和 conda-forge,并提供 shell 集成以便命令切换目录。

核心功能

  • 01按分支名切换、创建、列出和删除工作树
  • 02一条命令即可在新工作树中启动 Claude 等 AI 代理
  • 03可配置的工作树目录路径模板
  • 04在创建、合并前后等事件触发钩子命令
  • 05在 APFS、btrfs 和 XFS 上跨工作树共享 target/、node_modules/ 等构建缓存
  • 06通过 wt switch pr:123 直接检出 Pull Request 分支

适用场景

  • 让多个 AI 编程代理分别在独立功能分支上工作,避免改动冲突
  • 同时查看和测试多个分支,每个工作树运行各自的开发服务器
  • 在终端中完成功能分支的压缩、变基并合并到主分支
  • 把同事的 Pull Request 检出到单独目录,不打断当前工作

快速上手

  1. 1

    通过 Homebrew 安装并设置 shell 集成

    brew install worktrunk && wt config shell install
  2. 2

    为新功能创建一个 worktree

    wt switch --create feature-auth
  3. 3

    列出所有 worktree 及其状态

    wt list

使用前须知

  • 元数据中的许可证显示为 NOASSERTION,使用前请自行核实仓库的许可证条款。
  • 命令要更改目录需要 shell 集成;Windows 下默认命令名不同(git-wt)。

标签

常见问题

worktrunk 是什么?
一个用 Rust 编写的 Git worktree 管理 CLI,可按分支名切换和管理工作树,适合并行运行多个 AI 编程代理。 Worktrunk 是一个管理 Git worktree 的命令行工具。你不必再手动处理路径和原始 git 命令,而是直接用分支名操作工作树:`wt switch` 切换,`wt list` 查看每个工作树的状态,`wt remove` 连同分支一起清理。为新分支创建工作树只需一条命令,目录路径由可配置的模板生成。
worktrunk 可以免费使用吗?用的什么许可证?
worktrunk 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
worktrunk 还在维护吗?
活跃维护中。worktrunk 最近一次提交是在 2026年10月21日。
worktrunk 适合用来做什么?
让多个 AI 编程代理分别在独立功能分支上工作,避免改动冲突 同时查看和测试多个分支,每个工作树运行各自的开发服务器 在终端中完成功能分支的压缩、变基并合并到主分支 把同事的 Pull Request 检出到单独目录,不打断当前工作
worktrunk 怎么安装和运行?
通过 Homebrew 安装并设置 shell 集成: brew install worktrunk && wt config shell install 为新功能创建一个 worktree: wt switch --create feature-auth 列出所有 worktree 及其状态: wt list
在哪里获取 worktrunk?
源代码和安装说明在 GitHub 上:https://github.com/max-sixty/worktrunk

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目