git-worktree-runnerで複数ブランチを同時に開発する
本記事は、Luup Advent Calendar 2025の8日目の記事になります。
こんにちは、Operation開発チームでバックエンドを担当している大瀧です。
今回は、複数ブランチでの並行開発を効率化するCLIツール「git-worktree-runner(gtr)」についてご紹介します。
ローカルでのコードレビューや、機能開発の合間にhotfixの対応等々、日々の開発で頻繁にブランチを切り替える場面は多いと思います。その度にgit stashで作業を退避して、後でgit stash popで戻して...という作業に消耗していませんか?
あるいはgit worktreeを使っているけど、worktreeを作成するたびに依存関係のインストールや、.gitignoreに指定されている.envファイルなどのコピー作業が必要になるのも煩わしいですよね。
そんな方にこそ、git-worktree-runnerがおすすめです。
git worktreeとは
まず、git worktreeについて簡単に説明します。git worktreeはGitの機能で、同じリポジトリの複数のブランチを異なるディレクトリで同時にチェックアウトできるようにするものです。
通常のブランチ切り替えでは、以下のような課題があります。
- 作業中の変更をstashする必要がある
- 依存関係の再インストールが必要になることがある
- コンテキストスイッチのコストが高い
git worktreeを使えば、各ブランチが独立したディレクトリとして存在するため、これらの問題を解決できます。
しかし、git worktree自体にも課題があります。
- worktreeを作成するたびに
npm installなどの依存関係のインストールが必要 -
.envなどの.gitignoreに指定されているファイルは手動でコピーが必要 - worktreeのパスを覚えておく必要があり、エディタで開くのに一手間かかる
git-worktree-runnerはこれらの課題を解決してくれます。
git-worktree-runnerとは
git-worktree-runner(gtr)は、CodeRabbitが開発したgit worktreeの操作を簡単にするCLIツールです。
主な特徴として以下があります。
- シンプルなコマンドでworktreeを作成・管理
- エディタ(Cursor、VS Code、Zed)との統合
- AIコーディングツール(Claude Code、Codexなど)との統合
- ファイルやディレクトリの自動コピー機能
- フック機能による自動化
インストール方法
macOS/Linuxでのインストールは以下の通りです。
git clone https://github.com/coderabbitai/git-worktree-runner.git
cd git-worktree-runner
sudo ln -s "$(pwd)/bin/git-gtr" /usr/local/bin/git-gtr
これでGitのサブコマンドとしてgit gtrが使えるようになります。
基本的な使い方
初期設定
まず、デフォルトのエディタとAIツールを設定します。
git gtr config set gtr.editor.default vscode
git gtr config set gtr.ai.default claude
worktreeの作成
新しいworktreeを作成するには以下のコマンドを実行します。
git gtr new my-feature
これでmy-featureブランチ用のworktreeが作成されます。
エディタで開く
作成したworktreeをエディタで開くには以下のコマンドを実行します。
git gtr editor my-feature
設定したデフォルトエディタ(上記の例ではVS Code)でworktreeが開きます。
AIツールの起動
worktreeでAIコーディングツールを起動するには以下のコマンドを実行します。
git gtr ai my-feature
設定したデフォルトAIツール(上記の例ではClaude Code)が起動します。
worktreeの削除
作業が完了したらworktreeを削除します。
git gtr rm my-feature
主なコマンド一覧
| コマンド | 説明 |
|---|---|
git gtr new <branch> |
新しいworktreeを作成 |
git gtr new <branch> --editor |
worktree作成後に自動でエディタを開く |
git gtr new <branch> --from <ref> |
指定したブランチ・タグ・コミットからworktreeを作成する |
git gtr new <branch> --from-current |
現在のブランチをベースにworktreeを作成する |
git gtr editor <branch> |
worktreeをエディタで開く |
git gtr ai <branch> |
AIコーディングツールを起動 |
git gtr run <branch> <command> |
worktree内でコマンドを実行 |
git gtr rm <branch> |
worktreeを削除 |
git gtr list |
すべてのworktreeを一覧表示 |
VSCodeのSource Controlタブでもworktreeが表示され、操作が可能です。

.gtrconfig による便利な設定
.gtrconfig ファイルを用意することで、以下のような設定が可能です。
- ファイルやディレクトリの自動コピー
- worktree作成・削除時のフック
- デフォルトのエディタやAIツールの設定
[copy]
include = **/.env.example
exclude = **/.env
includeDirs = node_modules
excludeDirs = node_modules/.cache
[hooks]
postCreate = npm install
postCreate = npm run build
[defaults]
editor = vscode
ai = claude
利用可能なセクション
| セクション | オプション | 説明 |
|---|---|---|
[copy] |
include |
コピー対象ファイルのパターン |
exclude |
コピー除外パターン | |
includeDirs |
コピー対象ディレクトリ | |
excludeDirs |
コピー除外ディレクトリ | |
[hooks] |
postCreate |
worktree作成後に実行するコマンド |
postRemove |
worktree削除後に実行するコマンド | |
[defaults] |
editor |
デフォルトエディタ(cursor、vscode、zedなど) |
ai |
デフォルトAIツール(claude、codexなど) |
設定の優先順位
設定は以下の優先順位`で適用されます。
-
git config --local(.git/config)- 個人設定 -
.gtrconfig(リポジトリルート)- チーム設定 -
git config --global(~/.gitconfig)- ユーザー設定
実際の開発フロー
実際の開発では以下のようなフローで使用しています。
# 機能Aのworktreeを作成してエディタで開く
git gtr new feature-a
git gtr editor feature-a
# 別ターミナルで機能Bのworktreeを作成してAIツールで開発
git gtr new feature-b
git gtr ai feature-b
# それぞれ独立して開発を進められる
# 作業完了後
git gtr rm feature-a
git gtr rm feature-b
これにより、複数の機能を並行して開発する際のコンテキストスイッチのコストを大幅に削減できます。
AIエージェントとの相性
git-worktree-runnerは、Claude CodeなどのAIコーディングエージェントとの相性が良いです。
- 各worktreeが独立しているため、複数のAIエージェントを並行して動かせる
- 一つのタスクをAIに任せている間、別のworktreeで手動開発を進められる
- AIが生成したコードの影響範囲が明確に分離される
まとめ
git-worktree-runnerを使うことで、複数ブランチでの並行開発がより簡単になります。特にAIコーディングツールとの統合により、複数のタスクを効率的に進められるようになります。
従来のブランチ切り替えによるコンテキストスイッチのコストに悩んでいる方は、ぜひ試してみてください。
Discussion