Worktrunk

项目简介

Worktrunk 是面向并行 AI 代理工作流的 Git worktree 管理 CLI。它让 worktree 像分支一样易用：worktree 以分支名寻址，路径由可配置模板计算，接受分支的命令也接受该 worktree 的检出路径。它包含核心命令，以及用于简化大量并行变更的便利功能。

核心功能

• 核心命令让 worktree 像分支一样易用：wt switch、wt list、wt merge 和 wt remove。
• 钩子可在创建、合并前、合并后等工作流节点运行命令。
• LLM 提交信息可根据差异生成提交信息。
• 合并工作流可用一条命令完成压缩、变基、合并和清理。
• 交互式选择器可浏览 worktree，并查看流式 CI 状态、差异、日志、PR 和评论预览。
• 写时复制构建缓存让多个 worktree 在 APFS、btrfs 和 XFS 上共享 target、node_modules 等目录，无需构建或复制。

适用场景

• 在同一仓库上并行运行多个 AI 编码代理，每个代理使用自己的 Git worktree。
• 用 wt switch -c -x claude feat 一条命令创建分支和 worktree 并启动 Claude。
• 用 wt list 查看各 worktree 状态，并用 wt remove 清理 worktree 和分支。
• 按 PR 工作流或本地合并工作流完成后进行清理。

快速开始

• 在 macOS 或 Linux 上用 Homebrew 安装：brew install worktrunk，然后运行 wt config shell install。
• 也可用 Cargo 安装：cargo install worktrunk，然后运行 wt config shell install。
• 用 wt switch --create feature-auth 创建并切换到新的功能 worktree。
• 用 wt list 列出 worktree；完成后用 wt remove 移除 worktree。
• 并行代理可使用 wt switch -x claude -c feature-a -- 'Add user authentication'。

部署与要求

• 支持的安装方式包括 macOS 和 Linux 上的 Homebrew、Cargo、Arch Linux pacman、Conda 或 Pixi，以及 Windows 上的 Winget。
• 在 Windows 上，Winget 将 Worktrunk 安装为 git-wt，因为 wt 与 Windows Terminal 的命令冲突。
• 通过 wt config shell install 安装 shell 集成；改变目录的命令需要 shell 集成。

采用前须知

• 许可证：Other。在使用、修改或分发项目前，请确认其具体条款。