複数ブランチの開発環境を一瞬で切り替える

Git worktreeを使って、ブランチごとに独立した作業ディレクトリを作成・管理するCLIツールです。

• メインブランチで作業中に、緊急のバグ修正が入った
• 複数の機能ブランチを並行して開発したい
• PRレビュー用に別ブランチをすぐに確認したい
• .envなどgitignoreされたファイルも新しい作業環境にコピーしたい

npm install -g wtcompose

プロジェクトのルートに wturbo.yaml を作成:

base_branch: main

# gitignoreされているファイルも新しいworktreeにコピー
copy_files:
  - .env
  - .env.local

# 新しいブランチ用のworktreeを作成
wturbo create feature/awesome-feature

# 作業ディレクトリに移動
cd ../worktree-feature-awesome-feature

# 作業完了後、worktreeを削除
wturbo remove feature/awesome-feature

新しいworktreeを作成します。

wturbo create feature/new-feature
wturbo create bugfix/urgent-fix

処理内容:

1. git worktree add でブランチ用の作業ディレクトリを作成
2. copy_files で指定したファイルをコピー
3. start_command を実行（設定時のみ）

オプション:

• -p, --path <path> - worktreeの作成場所を指定（デフォルト: 親ディレクトリに worktree-<branch名> で作成）
• --no-create-branch - 既存のブランチを使用（新規作成しない）

worktreeを削除します。

wturbo remove feature/new-feature

処理内容:

1. end_command を実行（設定時のみ）
2. git worktree remove でworktreeを削除

オプション:

• -f, --force - 未コミットの変更があっても強制削除

現在のworktree一覧を表示します。

wturbo status

出力例:

🌿 Git Worktrees (3 total)
  → main: /Users/me/project
    feature/auth: /Users/me/worktree-feature-auth
    bugfix/login: /Users/me/worktree-bugfix-login

wturbo.yaml, wturbo.yml, .wturbo.yaml, .wturbo.yml のいずれかをプロジェクトルートに配置します。

base_branch: main

gitignoreされているファイルや設定ファイルを新しいworktreeにコピー:

copy_files:
  - .env
  - .env.local
  - .claude          # ディレクトリも可
  - config/local.json

worktree作成時・削除時にスクリプトを実行:

# 作成後に実行（依存関係のインストールなど）
start_command: ./scripts/setup.sh

# 削除前に実行（クリーンアップなど）
end_command: ./scripts/cleanup.sh

base_branch: main
docker_compose_file: ./docker-compose.yml

copy_files:
  - .env
  - .env.local
  - .secrets
  - config/

start_command: npm install && npm run db:migrate
end_command: docker compose down

env:
  file:
    - .env
    - .env.local
  adjust:
    APP_PORT: 1000    # ポート番号に+1000
    DB_PORT: 1000

• Node.js 18+
• Git

MIT