Worktree Clean
Clean up a worktree branch by fetching fresh state from origin and hard-resetting to a target branch.
Usage
/git-worktree-clean [branch]
Arguments:
- branch (optional): Target branch to reset to. Default: origin/latest
Help
If the user provides help as an argument:
-
Explain how to use this command
-
Explain prerequisites
-
DO NOT proceed, exit immediately
Prerequisites
-
Git CLI must be available
-
Working directory should be a git worktree (not the main repository)
-
No critical uncommitted changes - warn user if dirty
Workflow
STEP 1: Verify Environment
Check if we're in a git worktree
git rev-parse --is-inside-work-tree || exit 1
Check for uncommitted changes
if [ -n "$(git status --porcelain)" ]; then echo "WARNING: Uncommitted changes detected" git status --short fi
If uncommitted changes exist, STOP and ask user for confirmation before proceeding.
STEP 2: Fetch Fresh State
Fetch latest from origin
git fetch origin
STEP 3: Hard Reset to Target
Default to origin/latest if no argument provided
TARGET_BRANCH="${ARGUMENTS:-origin/latest}"
Hard reset to target
git reset --hard "$TARGET_BRANCH"
STEP 4: Verify Clean State
Show current state
git log --oneline -1 git status
Definition of Done
-
Working tree is clean
-
HEAD matches target branch
-
User informed of reset result