coderabbitai/git-worktree-runner

这是什么？

核心功能

• 01通过分支名用简短命令创建、列出、重命名和删除工作树
• 02使用 `git gtr pr` 将 Pull Request 检出到工作树中
• 03按包含和排除规则将环境变量与配置文件复制到新工作树
• 04执行创建后的钩子，例如自动安装依赖
• 05借助内置适配器用支持的编辑器打开工作树，或启动 AI 编程工具
• 06清理已合并或已关闭 PR/MR 对应的工作树

适用场景

• 在不打断当前功能开发的情况下评审同事的 Pull Request
• 让多个 AI 编程代理各自在独立分支上并行工作
• 保留一个干净的 main 工作树用于运行测试或构建
• 在团队内统一每个分支的环境文件复制和依赖安装流程

快速上手

1. 1

   通过 Homebrew 安装（macOS）

   brew tap coderabbitai/tap && brew install git-gtr
2. 2

   或克隆仓库

   git clone https://github.com/coderabbitai/git-worktree-runner.git
3. 3

   在仓库目录中运行安装脚本

   ./install.sh
4. 4

   为分支创建 worktree

   git gtr new my-feature

使用前须知

• !需要 Bash 3.2 及以上以及 Git 2.17 及以上版本；Windows 仅支持通过 Git Bash 使用。
• !在 Windows 上必须保留完整的仓库目录，仅复制 bin/git-gtr 会导致其无法启动。

收录于专题

标签

常见问题

git-worktree-runner 是什么？

基于 Bash 的命令行工具，封装 git worktree，用于按分支创建、配置和删除工作树，并可一键启动编辑器或 AI 编程工具。 gtr（Git Worktree Runner）是一个命令行工具，让 git worktree 更易用。worktree 允许同一仓库的多个分支同时检出到不同文件夹中，因此可以在不 stash 或切换分支的情况下开发功能、评审 PR 或在 main 上跑测试。gtr 用 `git gtr new`、`git gtr pr 123`、`git gtr rm` 等简短命令封装了原始的 git worktree 操作。

git-worktree-runner 可以免费使用吗？用的什么许可证？

git-worktree-runner 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

git-worktree-runner 还在维护吗？

活跃维护中。git-worktree-runner 最近一次提交是在 2026年11月6日。

git-worktree-runner 适合用来做什么？

在不打断当前功能开发的情况下评审同事的 Pull Request 让多个 AI 编程代理各自在独立分支上并行工作 保留一个干净的 main 工作树用于运行测试或构建 在团队内统一每个分支的环境文件复制和依赖安装流程

git-worktree-runner 怎么安装和运行？

通过 Homebrew 安装（macOS）: brew tap coderabbitai/tap && brew install git-gtr 或克隆仓库: git clone https://github.com/coderabbitai/git-worktree-runner.git 在仓库目录中运行安装脚本: ./install.sh 为分支创建 worktree: git gtr new my-feature

在哪里获取 git-worktree-runner？

源代码和安装说明在 GitHub 上：https://github.com/coderabbitai/git-worktree-runner