git prune: Usage, Options & Common CI Errors
git prune removes objects that are no longer reachable from any ref.
Prune is the low-level cleanup that permanently drops dangling objects. It is destructive to recovery, so most pipelines should run git gc (which prunes safely) rather than prune directly.
What it does
git prune deletes loose objects that are unreachable from any ref and older than the expiry window, reclaiming space but also removing the only copies of orphaned commits.
Common usage
Terminal
git prune -n # dry run: list what would go
git prune
git prune --expire=2.weeks.ago
git gc # the recommended safe wrapperOptions
| Flag | What it does |
|---|---|
| -n / --dry-run | Show what would be pruned |
| -v / --verbose | Report each pruned object |
| --expire <time> | Only prune objects older than this |
| -- | Treat following args as heads to protect |
Common errors in CI
prune makes reflog- and stash-based recovery impossible for the objects it removes, so never run it while a rebase/merge is mid-flight or right after a reset you might want to undo. Prefer git gc, which runs prune with safe defaults and respects the reflog expiry window.
Related guides
git gc: Usage, Options & Common CI Errorsgit gc compresses and prunes the object database to keep the repo fast and small. Reference for --aggressive,…
git repack: Usage, Options & Common CI Errorsgit repack combines loose objects and packs into fewer, tighter packfiles. Reference for -a, -d, -A, and the…
git count-objects: Usage, Options & Common CI Errorsgit count-objects reports how many loose objects and packs a repo holds and their disk size. Reference for -v…
git reflog: Usage, Options & Common CI Errorsgit reflog records where HEAD and branches have been, so you can recover lost commits. Reference for show, ex…