git-wt

name	git-wt
description	Use the git-wt command to create an isolated Git worktree for a task, keeping the main branch clean. After finishing, clean up the worktree based on whether changes exist. Only trigger when the user explicitly requests worktree isolation — e.g., "use a worktree", "use wt", "work on a separate branch", "isolate this in a worktree".

Git Worktree Workflow

Use git-wt to create a worktree and do all work there, keeping the main branch untouched. If anything goes wrong, git wt -d cleanly removes the worktree and branch.

Step 1: Create the worktree

Choose a branch name from the task, then run:

git wt <branch-name> --nocd

The worktree is created at .worktrees/<branch-name>/. Record the printed path as WORKTREE_PATH.

Step 2: Do all work inside the worktree

Every operation must target WORKTREE_PATH:

• Read/Edit/Write tools: use absolute paths like $WORKTREE_PATH/src/...
• Bash commands: cd $WORKTREE_PATH && <command>

Step 3: Report completion

When done, tell the user:

• What files changed and a brief summary
• The worktree path
• How to merge (e.g., cd $WORKTREE_PATH && git push -u origin <branch-name> → open a PR)

Step 4: Clean up

No changes (nothing committed or modified)

Delete automatically — no need to ask the user.

git wt -d <branch-name>

Changes or commits exist

Ask the user: keep or delete?

• Keep: leave the worktree and branch as-is. Let the user know they can return with cd $WORKTREE_PATH.
• Delete: warn that uncommitted changes and commits will be lost, then delete only if the user confirms.

# Normal delete (branch already merged)
git wt -d <branch-name>

# Force delete (unmerged changes — only if user explicitly requests)
git wt -D <branch-name>

Branch naming

Type	Prefix	Example
Feature / change	feat/	feat/add-dark-mode
Bug fix	fix/	fix/image-upload-error

When linked to an issue, include the issue number: feat/16-add-dark-mode, fix/20-image-upload-error.

Parallel multi-agent work

When spawning multiple subagents with the Agent tool, give each its own branch and worktree:

git wt feat/feature-a --nocd  # → .worktrees/feat/feature-a
git wt feat/feature-b --nocd  # → .worktrees/feat/feature-b

Pass each agent its explicit worktree path so they don't step on each other.