cleanup

name	cleanup
description	Git branch hygiene - delete merged/closed branch, prune stale refs, sync dependencies
user_invocable	true
triggers	["/cleanup"]

Git Cleanup Skill

Automates git branch hygiene after merging or closing PRs. Safely deletes merged branches (and force-deletes closed/abandoned branches), prunes stale remote tracking refs, syncs dependencies, and runs garbage collection.

Workflow

Execute these steps in order:

1. Check current branch

git branch --show-current

Store the result as CURRENT_BRANCH.

2. Guard against main/master

If CURRENT_BRANCH is main or master:

• Report: "Already on main branch. No branch to clean up."
• Skip to step 7 (pull latest) and continue from there.

3. Check for uncommitted changes

git status --porcelain

If output is non-empty:

• Warn the user: "You have uncommitted changes. Please commit or stash them first."
• Stop and do not proceed.

4. Check if branch is merged or closed

First check for merged PRs:

gh pr list --state merged --head CURRENT_BRANCH --json number

If merged, proceed to step 5.

If not merged, check for closed PRs:

gh pr list --state closed --head CURRENT_BRANCH --json number

If closed (result is non-empty):

• Report: "Branch 'CURRENT_BRANCH' has a closed (unmerged) PR. Proceeding with deletion."
• Proceed to step 5 (will use force delete in step 6).

If neither merged nor closed:

• Check if the branch is merged locally: git branch --merged main | grep -w CURRENT_BRANCH
• If not merged anywhere, warn: "Branch 'CURRENT_BRANCH' does not appear to be merged or closed. Use git branch -D manually if you want to force delete."
• Stop and do not proceed.

Store whether the branch was MERGED or CLOSED for use in step 6.

5. Switch to main

git checkout main

6. Delete the branch

If branch was MERGED:

git branch -d CURRENT_BRANCH

If branch was CLOSED (PR closed without merging):

git branch -D CURRENT_BRANCH

Report: "Deleted branch CURRENT_BRANCH." (mention if force-deleted due to closed PR)

7. Pull latest

git pull origin main

8. Prune remote tracking refs

git fetch --prune

9. Delete stale local branches

Find and delete local branches whose upstream is gone:

git for-each-ref --format '%(refname:short) %(upstream:track)' refs/heads | while read branch track; do
  if [ "$track" = "[gone]" ]; then
    git branch -d "$branch" 2>/dev/null && echo "Deleted stale branch: $branch"
  fi
done

Report any branches deleted.

10. Sync dependencies

• Run bun install at the repository root so bun.lock (and node_modules) stay in sync.
• If the docs/ workspace has its own bun.lock, run cd docs && bun install as well.

11. Git garbage collection

git gc --prune=now

12. Summary

Report completion:

• Branch deleted (if applicable)
• Number of stale branches pruned
• Dependencies synced (which package manager)
• Garbage collection complete

Error Handling

• Dirty working tree: Stop immediately and ask user to commit/stash
• Branch not merged or closed: Warn and stop - never force delete without explicit user request
• Branch closed (not merged): Force delete with -D since branch is abandoned
• Already on main: Skip branch deletion, continue with pull/prune/gc
• No remote: If git pull fails due to no remote, continue with local operations
• gh CLI not available: Fall back to git branch --merged check