worktree-cleanup

Worktree Cleanup

Clean up merged worktrees by finding the oldest merged branch, consolidating settings, and removing stale worktrees.

Additional info: $ARGUMENTS

<current_state> Current branch: git branch --show-current Current worktrees: git worktree list </current_state>

<execution_steps> <step_0> Detect git hosting provider <detect_provider> <check_remote_url>git remote get-url origin</check_remote_url> <identify_host> - github.com → Use gh CLI - gitlab.com → Use glab CLI - Other → Ask user which CLI tool to use </identify_host> <store_as>$GIT_HOST_CLI (e.g., "gh", "glab")</store_as> </detect_provider>

Detect git hosting provider and select appropriate CLI tool for PR verification </step_0>

<step_1> Determine default branch and verify we're on it <find_default_branch> git symbolic-ref refs/remotes/origin/HEAD | sed 's@^refs/remotes/origin/@@' git remote show origin | grep 'HEAD branch' | cut -d: -f2 | tr -d ' ' <store_as>$DEFAULT_BRANCH (typically "main" or "master")</store_as> </find_default_branch> <check_current_branch>git branch --show-current</check_current_branch> Current branch must equal $DEFAULT_BRANCH <error_if_not_default>Exit with error: "This command must be run from the default branch ($DEFAULT_BRANCH)"</error_if_not_default> Ensure we're consolidating to the default branch worktree </step_1>

<step_2> Get list of all worktrees git worktree list --porcelain <parse_output>Extract worktree paths and branch names</parse_output> <exclude_default>Filter out the default branch worktree from cleanup candidates</exclude_default> Identify all worktrees that could potentially be cleaned up </step_2>

<step_3> Find oldest worktree by directory age <get_worktree_ages> <detect_platform>uname -s (returns "Darwin" for macOS, "Linux" for Linux)</detect_platform> <command_macos>git worktree list | grep -v "[$DEFAULT_BRANCH]" | awk '{print $1}' > /tmp/worktrees-$$.txt && while IFS= read -r path; do echo "$(/usr/bin/stat -f '%Sm' -t '%Y-%m-%d %H:%M' "$path" 2>/dev/null)|$path"; done < /tmp/worktrees-$$.txt | sort; rm -f /tmp/worktrees-$$.txt</command_macos> <command_linux>git worktree list | grep -v "[$DEFAULT_BRANCH]" | awk '{print $1}' > /tmp/worktrees-$$.txt && while IFS= read -r path; do echo "$(stat -c '%y' "$path" 2>/dev/null | cut -d. -f1)|$path"; done < /tmp/worktrees-$$.txt | sort; rm -f /tmp/worktrees-$$.txt</command_linux> List all worktrees sorted by directory modification time (oldest first) <critical_notes> - Replace $DEFAULT_BRANCH with value from step_1 (e.g., "main" or "master") - grep "[branch]" matches branch name in brackets, not paths containing the word - Temp file approach avoids subshell parsing issues with piped while-loops - /usr/bin/stat on macOS avoids homebrew stat conflicts </critical_notes> <expected_output_format>YYYY-MM-DD HH:MM|/full/path/to/worktree (oldest first)</expected_output_format> </get_worktree_ages> <filter_recent> <exclude_new>For worktrees created within the last 24 hours, let user know that this worktree might not be worth cleaning</exclude_new> <get_current_time>date +"%Y-%m-%d %H:%M"</get_current_time> </filter_recent> <select_oldest> <extract_branch_name>Parse branch name from oldest worktree path</extract_branch_name> <important_note>DO NOT use "git branch --merged" to check merge status - it's unreliable</important_note> <proceed_to_pr_check>Move directly to step 4 to verify PR merge status instead</proceed_to_pr_check> </select_oldest> Identify oldest worktree candidate - actual merge verification happens via PR/MR in next step </step_3>