worktree

Git Worktree Management

Wraps the user's git wt aliases for worktree operations.

Available Commands

Alias	Description
gwl	List all worktrees
gwa <branch> [start-point]	Create/switch worktree (also creates .envrc with CLAUDE_CODE_TASK_LIST_ID)
gwd <branch>	Safe delete worktree + branch
gwD <branch>	Force delete worktree + branch
gwac <branch>	Create with .env* files copied
gwn <branch>	Create but stay in current dir
gwall <branch>	Create with ignored + untracked files copied

Usage

Based on $ARGUMENTS, perform the appropriate action:

No arguments or "list"

gwl

Show the worktree list to the user.

"create " or "add " or just ""

Before creating, always ask the user:

"Do you want to branch off main (default) or a different base branch?"

• If the user says yes / confirms default → use main (or master if that's the default branch)
• If the user specifies a different branch → use that as the start-point

# Default: checkout from main/master
gwa <branch> main

# From a user-specified base branch
gwa <branch> <start-point>

"delete " or "remove "

# Safe delete (default)
gwd <branch>

# Force delete only if user explicitly asks
gwD <branch>

Always confirm with the user before force-deleting.

"copy " (with env/untracked files)

gwall <branch>

Important Notes

• The default branch (main/master) is protected from deletion.
• Worktrees are stored in the directory configured by wt.basedir (default: ../{gitroot}-wt).
• gwa automatically creates .envrc with CLAUDE_CODE_TASK_LIST_ID set to the branch name for Claude Code task tracking.
• Always show the user the worktree list after create/delete operations so they can see the result.
• When deleting, prefer safe delete (gwd) unless the user explicitly requests force (gwD).