# git-prune(1) - man - phpMan

[GIT-PRUNE(1)](https://www.chedong.com/phpMan.php/man/GIT-PRUNE/1/markdown)                                 Git Manual                                 [GIT-PRUNE(1)](https://www.chedong.com/phpMan.php/man/GIT-PRUNE/1/markdown)


## NAME
       git-prune - Prune all unreachable objects from the object database

## SYNOPSIS
       _git_ _prune_ [-n] [-v] [--progress] [--expire <time>] [--] [<head>...]


## DESCRIPTION
           **Note**
           In most cases, users should run _git_ _gc_, which calls _git_ _prune_. See the section "NOTES",
           below.

       This runs _git_ _fsck_ _--unreachable_ using all the refs available in **refs/**, optionally with
       additional set of objects specified on the command line, and prunes all unpacked objects
       unreachable from any of these head objects from the object database. In addition, it prunes
       the unpacked objects that are also found in packs by running _git_ _prune-packed_. It also
       removes entries from .git/shallow that are not reachable by any ref.

       Note that unreachable, packed objects will remain. If this is not desired, see [**git-repack**(1)](https://www.chedong.com/phpMan.php/man/git-repack/1/markdown).

## OPTIONS
### -n, --dry-run
           Do not remove anything; just report what it would remove.

### -v, --verbose
           Report all removed objects.

### --progress
           Show progress.

### --expire <time>
           Only expire loose objects older than <time>.

       --
           Do not interpret any more arguments as options.

       <head>...
           In addition to objects reachable from any of our references, keep objects reachable from
           listed <head>s.

## EXAMPLES
       To prune objects not used by your repository or another that borrows from your repository via
       its **.git/objects/info/alternates**:

           $ git prune $(cd ../another && git rev-parse --all)


## NOTES
       In most cases, users will not need to call _git_ _prune_ directly, but should instead call _git_
       _gc_, which handles pruning along with many other housekeeping tasks.

       For a description of which objects are considered for pruning, see _git_ _fsck_'s --unreachable
       option.

## SEE ALSO
       [**git-fsck**(1)](https://www.chedong.com/phpMan.php/man/git-fsck/1/markdown), [**git-gc**(1)](https://www.chedong.com/phpMan.php/man/git-gc/1/markdown), [**git-reflog**(1)](https://www.chedong.com/phpMan.php/man/git-reflog/1/markdown)

## GIT
       Part of the [**git**(1)](https://www.chedong.com/phpMan.php/man/git/1/markdown) suite


Git 2.34.1                                   02/26/2026                                 [GIT-PRUNE(1)](https://www.chedong.com/phpMan.php/man/GIT-PRUNE/1/markdown)