git-count-objects

Count all objects and display the total disk usage

$ git count-objects

$ git count-objects --human-readable

$ git count-objects --verbose

$ git count-objects --human-readable --verbose

git count-objects [-v] [-H] [--verbose] [--human-readable] [--disk-usage] [--no-verbose]

-v, --verbose
    Show size breakdown for each object type.

-H, --human-readable
    Print sizes in human readable format.

--disk-usage
    Show disk space usage.

--no-verbose
    Suppress verbose output. Useful to override `-v` in configuration.

The `git-count-objects` command counts the number of unpacked and packed git objects in a repository. It provides statistics about the sizes of various object types (blobs, trees, commits, tags) and also provides information about the size of the .pack files that store compressed object data. This is useful for understanding the overall size and structure of your git repository and for identifying potential bloat or inefficiencies. The output can be tailored to show object counts, disk space usage, and packfile details. The command is helpful when optimizing git repositories for size and performance, as well as diagnosing issues related to repository corruption or object reachability problems. It does not modify the repository itself; it only provides read-only information.

The disk space usage reported might differ slightly from actual disk space usage due to file system overhead and block size.

The verbose output (`-v`) shows the count and size of each object type (blob, tree, commit, tag). The disk usage output (`--disk-usage`) shows the amount of disk space consumed by packed and unpacked objects. The human readable format (`-H`) improves output readability.

The `git-count-objects` command has been present in Git since early versions, offering essential insight into repository object organization and consumption. It allows developers to monitor and optimize git repositories. This command allows developers to analyze repository object usage, allowing them to optimize performance.

git-fsck(1), git-prune(1), git-repack(1)