Clean Gone

Clean Gone

Delete local branches whose remote tracking is gone or merged, and remove their associated worktrees.

Arguments

Parse from $ARGUMENTS:

Preprocessed context

• Default remote: !git for-each-ref --format="%(upstream:remotename)" refs/​heads/​main 2>/​dev/​null || git remote | head -1 2>/​dev/​null || echo "origin"
• Default branch: !basename "$(git symbolic-ref refs/​remotes/​origin/​HEAD 2>/​dev/​null || echo refs/​remotes/​origin/​main)"
• gh CLI: !command -v gh >/​dev/​null 2>&1 && echo "available" || echo "unavailable"

Constraints

• First action MUST be Bash — preamble text wastes a turn and delays the actual cleanup
• Never delete the current branch — skip and report in summary
• Never remove the main worktree — only feature/​task worktrees
• Execute "${CLAUDE_SKILL_DIR}/​scripts/​clean-gone.sh" as a single Bash invocation
• Output summary directly as text (NOT via bash/​printf)

Workflow

Phase 1: Execute Cleanup Script

Execute "${CLAUDE_SKILL_DIR}/​scripts/​clean-gone.sh" immediately, passing through any flags from $ARGUMENTS.

• No flags → full cleanup (gone + merged branches + worktrees)
• --dry-run → preview only, no changes
• --no-worktrees → gone branches only, no worktree removal or merge detection
• Invalid flag → script exits with error, show valid options (--dry-run, --no-worktrees), stop

Phase 2: Output Summary

Parse script output line prefixes and render formatted summary directly as text.

Line prefixes (from script output):

Dry-run uses WOULD_DELETE, WOULD_REMOVE_WT, WOULD_SKIP, WOULD_KEEP, WOULD_KEEP_WT.

Summary format:

**Cleanup Summary**

Deleted:
  🗑️ fix/​old-feature (gone)
  🗂️ fix-old-feature-wt (worktree)

Skipped:
  ⚠️ feat/​current-work (current branch)

Kept:
  🗂️ wt-name (worktree) - branch (N unmerged)
  ℹ️ feat/​in-progress (14 unmerged)

Only include sections with items. Empty state: ✅ Repository already clean — no branches to process

Dry-run header: **Dry Run Preview** with "Would delete/​remove" phrasing.

Cleanup Logic

• Uses pre-resolved remote name and default branch from preprocessed context
• Deletes branches marked [gone] (remote tracking deleted)
• Deletes branches fully merged via rebase/​cherry-pick (git cherry)
• Deletes branches squash-merged via PR (gh pr list --state merged) when gh CLI is available
• Removes associated worktrees before branch deletion
• Skips main and current branch
• Falls back gracefully if gh CLI is unavailable (see preprocessed context)

Edge Cases

• Invalid flags: report unknown flag, show valid options, stop
• No cleanable branches: report "Repository already clean"
• Current branch is gone/​merged: skip deletion, warn in summary
• Uncommitted changes in worktree: force remove with --force flag
• No gh CLI (see preprocessed context): squash merges won't be detected, only git cherry used
• No remote configured: remote from preprocessed context used as fallback

Example Invocations

<example> Full cleanup:

/​git-clean-gone

</​example>

<example> Preview what would be deleted:

/​git-clean-gone --dry-run

</​example>

<example> Branches only, no worktree removal:

/​git-clean-gone --no-worktrees

</​example>