/switch

<butler_context> !${CLAUDE_PLUGIN_ROOT}/scripts/git/gitbutler-context.sh </butler_context>

<phantom_context> !${CLAUDE_PLUGIN_ROOT}/scripts/git/phantom-context.sh </phantom_context>

<gitbutler_incompatible>

This command does not work with GitButler.

If GITBUTLER_ACTIVE=true from <butler_context>:

Git worktrees are not compatible with GitButler virtual branches.

GitButler uses virtual branches instead of worktrees for parallel development.
All virtual branches exist in the same working directory - no switching needed!

With GitButler, you work on multiple branches simultaneously:
- `crew:git:butler:status` - View all virtual branches
- `crew:git:butler:assign` - Move files between branches

To use worktrees, first disable GitButler in this repository.

Exit immediately. Do not proceed with worktree commands.

</gitbutler_incompatible>

<objective>

Switch to a different worktree. Ask user to select if no argument provided.

</objective> <workflow>

Step 1: List Available Worktrees

phantom list

Step 2: Select Worktree (if no argument)

const worktrees = Bash({ command: "phantom list --names" }).trim().split("\n");
AskUserQuestion({
  questions: [
    {
      question: "Which worktree?",
      header: "Worktree",
      options: worktrees.slice(0, 4).map((wt) => ({
        label: wt,
        description: `Switch to ${wt}`,
      })),
      multiSelect: false,
    },
  ],
});

Step 3: Switch

wtPath=$(phantom where ${worktreeName})
cd "$wtPath"
pwd && git branch --show-current

</workflow>

<success_criteria>

• Worktree selected
• Directory changed to worktree path

</success_criteria>