Git Worktree Manager (for Claude Code)

git worktree と git gtr を使い、現在の作業を中断せずに別ブランチで操作を行う。

重要: Claude Code での使い方

使うべきコマンド:

• git gtr list - worktree 一覧
• git gtr new - worktree 作成
• git gtr run <branch> <command> - worktree 内でコマンド実行
• git gtr go <branch> - パス取得
• git gtr rm - worktree 削除

使ってはいけないコマンド:

• git gtr ai - 対話的 AI セッションを起動するため不適切
• git gtr editor - エディタを起動するため不適切

典型的なユースケース

1. 現在の作業を中断せずに main でテスト

# "1" は メインリポジトリを指す
git gtr run 1 npm test
git gtr run 1 npm run build

2. PR/別ブランチのコードを確認

# worktree 作成
git gtr new pr-review --from origin/feature-branch

# 依存関係をインストール (Node.jsプロジェクトの場合)
git gtr run pr-review npm ci

# コード確認
git gtr run pr-review cat src/main.ts
git gtr run pr-review git diff main...HEAD --stat

# 確認後に削除
git gtr rm pr-review --yes

3. 複数ブランチで並列テスト (subagent活用)

Taskツールで並列subagentを起動し、各worktreeでテストを実行:

# 各ブランチ用の worktree を作成
git gtr new feature-a --from origin/feature-a --yes
git gtr new feature-b --from origin/feature-b --yes

その後、Taskツールで2つの並列subagentを起動:

• subagent A: git gtr run feature-a npm ci && git gtr run feature-a npm test
• subagent B: git gtr run feature-b npm ci && git gtr run feature-b npm test

結果を集約して報告。完了後:

git gtr rm feature-a --yes
git gtr rm feature-b --yes

4. 別ブランチでビルド確認

git gtr new build-check --from main --yes
git gtr run build-check npm ci
git gtr run build-check npm run build
git gtr rm build-check --yes

コマンドリファレンス

一覧表示

git gtr list              # 人間向け
git gtr list --porcelain  # スクリプト向け (TAB区切り: path, name, branch)

作成

git gtr new <branch>                    # 新ブランチで作成
git gtr new <branch> --from <ref>       # 特定 ref から作成
git gtr new <branch> --from-current     # 現在のブランチから派生
git gtr new <branch> --yes --no-copy    # 非対話・ファイルコピーなし

コマンド実行 (最重要)

git gtr run <branch> <command...>

# 例
git gtr run main git status
git gtr run feature npm test
git gtr run 1 cat package.json        # "1" = メインリポジトリ

パス取得

git gtr go <branch>                   # パスを出力
# 例: /Users/user/project-worktrees/feature

削除

git gtr rm <branch>                   # 削除
git gtr rm <branch> --yes             # 確認なし
git gtr rm <branch> --delete-branch   # ブランチも削除

ファイル読み書き

worktree 内のファイルを直接操作する場合:

# パスを取得して Read/Edit ツールで操作
WORKTREE_PATH=$(git gtr go feature)
# → Read/Edit ツールで $WORKTREE_PATH/src/file.ts を操作

または:

# git gtr run 経由で cat/操作
git gtr run feature cat src/file.ts
git gtr run feature git diff

注意事項

• worktree は .git を共有するため、コミットは即座に反映される
• git gtr run は worktree ディレクトリで cd してからコマンドを実行する
• worktree 作成後は依存関係インストールが必要 (npm ci, bundle install 等)
• 作業完了後は git gtr rm でクリーンアップ推奨
• 並列テストはTaskツールでsubagentを使うとClaude Codeらしい実装になる