Skip to main content

git-clean-gone-branches

Clean up local branches whose remote tracking branch is gone. Use when the user says "clean up branches", "delete gone branches", "prune local branches", "clean gone", or wants to remove stale local branches that no longer exist on the remote. Also handles removing associated worktrees for branches that have them.

Jump to install

Source facts

Repository
All-The-Vibes/ATV-StarterKit
Last source activity
April 28, 2026 at 18:30
Detected SKILL.md language
English
Stars
51
Forks
15

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
2 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
git-clean-gone-branches
description
Clean up local branches whose remote tracking branch is gone. Use when the user says "clean up branches", "delete gone branches", "prune local branches", "clean gone", or wants to remove stale local branches that no longer exist on the remote. Also handles removing associated worktrees for branches that have them.
# Clean Gone Branches Delete local branches whose remote tracking branch has been deleted, including any associated worktrees. ## Workflow ### Step 1: Discover gone branches Run the discovery script to fetch the latest remote state and identify gone branches: ```bash bash scripts/clean-gone ``` [scripts/clean-gone](./scripts/clean-gone) The script runs `git fetch --prune` first, then parses `git branch -vv` for branches marked `: gone]`. If the script outputs `__NONE__`, report that no stale branches were found and stop. ### Step 2: Present branches and ask for confirmation Show the user the list of branches that will be deleted. Format as a simple list: ``` These local branches have been deleted from the remote: - feature/old-thing - bugfix/resolved-issue - experiment/abandoned Delete all of them? (y/n) ``` Wait for the user's answer using the platform's question tool (e.g., `ask_user` in Copilot CLI). If no question tool is available, present the list and wait for the user's reply before proceeding. This is a yes-or-no decision on the entire list -- do not offer multi-selection or per-branch choices. ### Step 3: Delete confirmed branches If the user confirms, delete each branch. For each branch: 1. Check if it has an associated worktree (`git worktree list | grep "\\[$branch\\]"`) 2. If a worktree exists and is not the main repo root, remove it first: `git worktree remove --force "$worktree_path"` 3. Delete the branch: `git branch -D "$branch"` Report results as you go: ``` Removed worktree: .worktrees/feature/old-thing Deleted branch: feature/old-thing Deleted branch: bugfix/resolved-issue Deleted branch: experiment/abandoned Cleaned up 3 branches. ``` If the user declines, acknowledge and stop without deleting anything.
View on GitHub