Repolode
投稿する
coderabbitai

coderabbitai/git-worktree-runner

ブランチごとの worktree の作成・設定・削除に加え、エディターやAIエージェントの起動もできる、git worktree をラップした Bash CLI。

GitHub で見る
スター
1,809
フォーク
114
未解決の Issue
11
最終コミット
昨日

これは何？

gtr（Git Worktree Runner）は、git worktree を使いやすくするコマンドラインツールです。worktree を使うと、同じリポジトリの複数のブランチを別々のフォルダーに同時にチェックアウトできるため、変更を stash したりブランチを切り替えたりせずに、機能開発やプルリクエストのレビュー、main でのテスト実行などができます。gtr は `git gtr new`、`git gtr pr 123`、`git gtr rm` のような短いコマンドで、git worktree の基本コマンドを扱えます。

新しい worktree は自動でセットアップできます。設定したパターンに一致する設定ファイルや環境ファイルをコピーし、依存関係のインストールなどの作成後フックを実行したうえで、エディターで worktree を開いたり、AIコーディングツールを起動したりできます。Cursor、VS Code、Zed などのエディターや、Claude Code、Codex、Gemini CLI などのAIツールには組み込みアダプターが用意されており、PATH 上のほかの安全なコマンドもフォールバックとして利用できます。`--porcelain` 出力モードを使うと、スクリプトやコーディングエージェントが新しい worktree のパスを安定して取得できます。

設定は git config に保存され、`.gtrconfig` ファイルでチーム共通のデフォルト設定も指定できます。このファイル内のフックやエディター・AIのデフォルト設定は、`git gtr trust` でユーザーが承認した後にのみ実行されます。macOS、Linux、Git Bash または WSL 経由の Windows で動作し、Git 2.17+ と Bash 3.2+ が必要です。

主な機能

  • 01ブランチ名を指定した短いコマンドで worktree を作成、一覧表示、名前変更、削除
  • 02`git gtr pr` でプルリクエストを worktree にチェックアウト
  • 03include／exclude パターンを使って、新しい worktree に環境ファイルや設定ファイルをコピー
  • 04依存関係のインストールなどの作成後フックを実行
  • 05対応エディターで worktree を開く、または組み込みアダプターでAIコーディングツールを起動
  • 06PR や MR がマージまたはクローズされた worktree をクリーンアップ

ユースケース

  • 現在進行中の機能開発を中断せずに、チームメイトのプルリクエストをレビューする
  • それぞれ別のブランチを使う複数のAIコーディングエージェントを並行して実行する
  • テストやビルドの実行用に、main のクリーンな worktree を維持する
  • 環境ファイルや依存関係のインストールなど、ブランチごとのセットアップをチーム内で標準化する

クイックスタート

  1. 1

    Homebrew でインストール（macOS）

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

    またはリポジトリを clone

    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 だけをコピーすると動作しないため、チェックアウト全体をそのまま置いておく必要があります。

収録されている特集

オープンソースの AI エージェント・フレームワークとアプリAI コーディングアシスタントとエージェントCLI・ターミナルツール

トピック

#git#git-worktree#cli#bash#developer-workflow#ai-agents#code-review

よくある質問

git-worktree-runner とは？
ブランチごとの worktree の作成・設定・削除に加え、エディターやAIエージェントの起動もできる、git worktree をラップした Bash CLI。 gtr（Git Worktree Runner）は、git worktree を使いやすくするコマンドラインツールです。worktree を使うと、同じリポジトリの複数のブランチを別々のフォルダーに同時にチェックアウトできるため、変更を stash したりブランチを切り替えたりせずに、機能開発やプルリクエストのレビュー、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 は何に使えますか？
現在進行中の機能開発を中断せずに、チームメイトのプルリクエストをレビューする それぞれ別のブランチを使う複数のAIコーディングエージェントを並行して実行する テストやビルドの実行用に、main のクリーンな worktree を維持する 環境ファイルや依存関係のインストールなど、ブランチごとのセットアップをチーム内で標準化する
git-worktree-runner のインストール方法は？
Homebrew でインストール（macOS）: brew tap coderabbitai/tap && brew install git-gtr またはリポジトリを clone: 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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト