git_pruner

An interactive terminal UI for pruning local git branches. It lists branches like git branch -vv --sort=-committerdate (most recently committed first), lets you re-sort on the fly, multi-select branches, and delete them — with a per-branch option to also delete the matching remote branch.

You can also view a branch's changes as a colorized diff, and fetch-and-prune to find branches whose upstream has been deleted so they can be cleaned up in one step.

Install

Requires Go 1.26+ and git on your PATH.

make build      # builds to ~/shared/bin/git_pruner (on PATH)

Then run it from inside any git repository:

git_pruner

To print the build's commit and date (from Go's automatic VCS stamping):

git_pruner version     # also --version, -v

Keybindings

Key	Action
↑/k, ↓/j	Move cursor
g / G	Jump to top / bottom
space	Toggle selection (the current branch cannot be selected)
a / n	Select all / clear selection
r	Toggle "also delete remote" for the row (needs an upstream)
v	View the branch's diff (green additions / red removals)
p	Fetch --all --prune, then select branches whose upstream is gone
s	Cycle sort field: committerdate -> name -> ahead/behind
o	Reverse sort direction
f	Toggle delete mode: safe -d <-> force -D
d / enter	Go to the confirmation screen
q / ctrl+c	Quit

On the confirmation screen, n/esc cancels. When no remote deletions are armed, y deletes. When at least one remote deletion is armed (R in the row), the prompt splits so remote deletion is never a single accidental keystroke: y deletes local branches only (sparing the remotes), while R deletes local + remote. If any branch is then refused by the safe delete (-d) because it isn't fully merged, a follow-up prompt offers to force delete (-D) just those branches — y discards their unmerged commits, n/esc keeps them.

Deletions run in the background with a live progress screen (a spinner plus a per-branch checklist), so the UI stays responsive while remote pushes complete.

In the diff view: ↑/↓ scroll, space/ctrl+d page down, ctrl+u/pgup page up, g/G jump to top/bottom, and q/esc/v return to the list.

Row format

> [x] R *  feature/foo        ↑2↓1 ✓  3 days ago   a1b2c3d  Fix the thing

• > cursor, [x] selected, R remote deletion armed, * current branch
• ahead/behind shown as ↑N↓M (= when in sync, gone in red when the upstream was deleted)
• a green ✓ after the track column means the upstream is merged into the remote default branch (origin/HEAD, else origin/main/origin/master) — i.e. the remote is safe to delete
• relative commit date, short hash, and commit subject

Viewing a branch's changes

Press v to see what a branch contains as a colorized patch — green for additions, red for removals, magenta hunk headers. The diff is computed against the repository's default branch (origin/HEAD, falling back to main, then master) using a three-dot diff (git diff <base>...<branch>), so it shows only the changes introduced on that branch since it diverged. The view is scrollable for large diffs; the header shows which base it was compared to.

Pruning gone branches

Press p to run git fetch --all --prune in the background (the UI stays responsive). Once it finishes, any local branch whose upstream was deleted is marked gone and automatically selected, and a status line reports how many were found. Press d to review and delete them.

This is the interactive equivalent of:

git fetch --all --prune && git branch -vv | awk '/: gone]/{print $1}' | xargs git branch -D

Gone branches are always removed with git branch -D (force), since -d refuses a branch whose upstream no longer exists — this is why selecting them via p prunes them even in safe mode.

Deletion behavior

• Local: git branch -d by default (refuses unmerged branches); f switches to git branch -D. Branches whose upstream is gone are always deleted with -D, regardless of the mode. When a -d delete is refused for being unmerged, a follow-up prompt lets you retry those branches with -D without leaving the results — no need to back out and re-select.
• Remote: when armed with r, runs git push <remote> --delete <branch>, where the remote is derived from the branch's upstream. Because this affects shared history, remote deletion requires the explicit R key on the confirmation screen — plain y deletes locals only. The confirmation screen also shows, per branch, whether the upstream is merged into the remote default (✓ merged / ⚠ not merged) to help you judge whether the remote is safe to delete.
• A confirmation screen always lists exactly what will be deleted before anything happens. Deletions then run concurrently in the background on a live progress screen, and a results screen reports per-branch success or failure.

Development

make test       # go test ./...
make vet        # go vet ./...
make clean      # remove the installed binary