worktree

name	worktree
description	Git worktree + tmux で並行作業セッションを起動する（Issue/PR/ブランチ対応）
disable-model-invocation	false
argument-hint	<Issue/PR URL, Issue number, or branch-name> [--model <model>] [--plan] [task description]
allowed-tools	Bash

Worktree 管理

Claude Code の --worktree フラグを活用して、並行作業セッションを tmux window として起動する。

前提

• tmux セッション内で実行することを想定

使用例

• /worktree https://github.com/owner/repo/issues/123
• /worktree https://github.com/owner/repo/pull/456 をレビューして
• /worktree feature/new-api 認証機能を実装して
• /worktree feature/new-api --model sonnet 認証機能を実装して
• /worktree feature/new-api --plan 設計を考えて

手順

以降の shell snippet 中のプレースホルダ <worktree-name> は手順 1 で決めた WNAME、<repo> は basename $(git rev-parse --show-toplevel) の値で、実行前に文字列置換すること。

1. worktree 名を生成

$ARGUMENTS の先頭トークンから判別する:

パターン	フォーマット	例
github.com/.../issues/<n>	issue-<number>	issue-123
github.com/.../pull/<n>	pr-<number>	pr-456
数字のみ	issue-<number>	issue-123
それ以外	/ を - に置換	feature-new-api

引数がない場合はユーザーに質問する。

1.5. 引数を解析

$ARGUMENTS から以下を抽出する:

• --model <value>: モデルを指定。指定がなければ --model 自体を付与しない（claude のデフォルトに委ねる）。
  • モデル値は絶対に変換・補完しないこと。ユーザーが指定した値をそのまま使う。
• --plan: plan mode フラグ。permission mode はデフォルトで auto、--plan 指定時のみ plan に上書きする。

MODEL_FLAG=""
PERM_FLAG="--permission-mode auto"
ARGS="$ARGUMENTS"

# Extract --model value as-is (do NOT normalize or alias the value)
if echo "$ARGS" | grep -q -- '--model '; then
  MODEL=$(echo "$ARGS" | sed 's/.*--model \([^ ]*\).*/\1/')
  MODEL_FLAG="--model '${MODEL}'"
  ARGS=$(echo "$ARGS" | sed 's/--model [^ ]*//' | xargs)
fi

# Extract --plan flag (overrides the default auto permission mode)
if echo "$ARGS" | grep -q -- '--plan'; then
  PERM_FLAG="--permission-mode plan"
  ARGS=$(echo "$ARGS" | sed 's/--plan//' | xargs)
fi

以降の手順では $ARGS をプロンプトとして使い、$MODEL_FLAG をモデル指定に、$PERM_FLAG を permission-mode オプションに使う。

2. Worktree を準備

claude --worktree は <repo>/.claude/worktrees/<name> に worktree を作成し、ブランチ名は worktree-<name> となる。 ただし CLAUDE.md や .claude/ が git 未追跡の場合、新規 worktree にはこれらが含まれない。

事前に worktree を作成し、未追跡の Claude 設定ファイルをコピーする prep スクリプトを /tmp/worktree-prep.sh に書き出す。

cat > /tmp/worktree-prep.sh << 'PREP'
#!/bin/bash
set -euo pipefail
REPO_ROOT=$(git rev-parse --show-toplevel)
WNAME="<worktree-name>"
WORKTREE_DIR="${REPO_ROOT}/.claude/worktrees/${WNAME}"

mkdir -p "$(dirname "$WORKTREE_DIR")"
git worktree add "$WORKTREE_DIR" -b "worktree-${WNAME}" 2>/dev/null || true

# Sync Claude config files (handles both tracked and untracked)
[ -e "$REPO_ROOT/CLAUDE.md" ] && cp -f "$REPO_ROOT/CLAUDE.md" "$WORKTREE_DIR/CLAUDE.md"
[ -d "$REPO_ROOT/.claude" ] && rsync -a --exclude='worktrees' "$REPO_ROOT/.claude/" "$WORKTREE_DIR/.claude/"
PREP
chmod +x /tmp/worktree-prep.sh

3. tmux で起動

tmux window のタイトルは <repository>/<worktree-name> とする。 repository 名は basename $(git rev-parse --show-toplevel) で取得する。

--model はユーザーが --model <value> を渡したときのみ付与する（$MODEL_FLAG 経由）。未指定なら claude のデフォルトモデルに委ねる。

[!IMPORTANT] tmux send-keys と複数行プロンプト

tmux send-keys は文字列中の改行を Enter キーとして送信するため、複数行プロンプトを直接渡すと途中で実行されてしまう。 必ず一時ファイルに書き出してから $(cat file) で渡すこと。

# Write prompt to temp file (use $ARGS with --model stripped)
cat > /tmp/worktree-prompt.txt << EOF
$ARGS
EOF

# Check tmux and launch (prep script runs first to ensure config files exist)
if tmux list-sessions 2>/dev/null; then
    tmux new-window -n "<repo>/<worktree-name>"
    tmux send-keys "bash /tmp/worktree-prep.sh && claude --worktree <worktree-name> ${MODEL_FLAG} ${PERM_FLAG} \"\$(cat /tmp/worktree-prompt.txt)\"" C-m
else
    echo "Not in tmux session. Run manually:"
    echo "  bash /tmp/worktree-prep.sh && claude --worktree <worktree-name> ${MODEL_FLAG} ${PERM_FLAG}"
fi

注意事項

• tmux セッション外で実行された場合は手動コマンドを表示
• --worktree はセッション終了時に変更がなければ自動削除、変更があれば確認される
• 一覧は git worktree list で確認可能