Cursor Worktreeとは？git worktreeで並列エージェントを動かす完全ガイド【2026年最新】

# 既存のブランチからworktreeを作成
git worktree add ../feature-auth feature/auth

# 新しいブランチを作りながらworktreeを作成
git worktree add -b feature/notifications ../feature-notifications

# 全worktreeの一覧を表示
git worktree list

# 使い終わったworktreeを削除
git worktree remove ../feature-auth

{
  "setup-worktree-unix": "npm install && cp .env.example .env.local",
  "setup-worktree-windows": "npm install; Copy-Item .env.example .env.local"
}

{
  "setup-worktree-unix": "SESSION=$(date +%s%N); AGENT_ID=1; while [ -f .task-claim-$AGENT_ID ]; do AGENT_ID=$((AGENT_ID+1)); done; echo $AGENT_ID > .agent-id; touch .task-claim-$AGENT_ID; echo 'Agent ID: '$AGENT_ID",
  "setup-worktree-windows": "..."
}

# メインプロジェクトのディレクトリで実行
cd ~/dev/my-app

# 2つのworktreeを並列で作成
git worktree add -b feat/auth ../my-app-auth
git worktree add -b feat/notification ../my-app-notification

# 作成されたか確認
git worktree list

# worktree1のセットアップ
cd ~/dev/my-app-auth
npm install
cp .env.example .env.local

# worktree2のセットアップ
cd ~/dev/my-app-notification
npm install
cp .env.example .env.local

# ターミナルから2つのCursorウィンドウを開く
cursor ~/dev/my-app-auth
cursor ~/dev/my-app-notification

# 1. worktreeのブランチの変更をメインにマージ
cd ~/dev/my-app
git merge feat/auth

# 2. worktreeディレクトリを削除
git worktree remove ../my-app-auth

# 3. ブランチも削除（任意）
git branch -d feat/auth

# 4. 古いworktreeの参照を整理
git worktree prune

{
  "name": "My App Dev Container",
  "image": "mcr.microsoft.com/devcontainers/typescript-node:18",
  "customizations": {
    "vscode": {
      "extensions": [
        "esbenp.prettier-vscode",
        "dbaeumer.vscode-eslint"
      ]
    }
  },
  "postCreateCommand": "npm install"
}