tj.git-extras/man/git-delete-gone-branches.md
Utsav Sabharwal e92878b81b
feat: add git-delete-gone-branches command (#1239)
* feat: add git-delete-gone-branches command

Adds a new command to delete local branches whose remote-tracking
branch has been deleted (shown as [gone] in git branch -vv).

This is a common need after PRs are merged and remote branches are
cleaned up, leaving stale local branches behind.

Features:
- Deletes all local branches with a gone remote in one command
- --dry-run / -n flag to preview branches before deletion

Closes #1220

* Address PR review feedback on git-delete-gone-branches

- Use git for-each-ref instead of git branch -vv to avoid false
  positives from commit messages containing ': gone]'
- Add interactive confirmation prompt by default; skip with -f/--force
- Add -p/--prune flag to run git fetch --prune before checking
- Add generated man page .1 and .html files

* Use GitHub profile for author contact in man page

* Fix gone-branch detection with nobracket format
2026-06-09 10:36:27 +08:00

1.1 KiB

git-delete-gone-branches(1) -- Delete branches whose remote is gone

SYNOPSIS

git-delete-gone-branches [-n|--dry-run] [-f|--force] [-p|--prune]

DESCRIPTION

Deletes all local branches whose remote-tracking branch has been deleted. This commonly happens after a pull request is merged and the remote branch is removed. By default, lists the branches and prompts for confirmation before deleting.

OPTIONS

-n, --dry-run

Show the branches that would be deleted without actually deleting them.

-f, --force

Skip the confirmation prompt and delete branches immediately.

-p, --prune

Run git fetch --prune before checking for gone branches, to ensure remote-tracking refs are up to date.

EXAMPLES

$ git delete-gone-branches

$ git delete-gone-branches --dry-run

$ git delete-gone-branches --force

$ git delete-gone-branches --prune

AUTHOR

Written by Utsav Sabharwal <https://github.com/codersofthedark>

REPORTING BUGS

<https://github.com/tj/git-extras/issues>

SEE ALSO

<https://github.com/tj/git-extras>