commit-graph Git Command Guide

The git commit-graph command manages Git commit graph files which store commit relationships and metadata to improve performance of commands like git log and git status.

git commit-graph Syntax:

git commit-graph write [<options>] [--stdin-packs|--stdin-commits]
git commit-graph verify [<options>]
git commit-graph read [<options>]

Options:

Option	Description
—progress	Force progress reporting
—append	Include all commits in the commit graph file
—no-append	Create a new file without appending
—reachable	Include reachable commits from current branch tips
—stdin-packs	Read pack indices from standard input
—stdin-commits	Read commits from standard input
—max-new-filters	Specify maximum number of new Bloom filters
—no-max-new-filters	Disable max-new-filters limit
—no-prune	Disable packed garbage collection
—split[=]	Enable commit-graph splitting
—size-multiple	Chain size multiple
—no-size-multiple	Disable size multiples
—expire-time	Expire files older than
—max-commits	Maximum number of commits in each file
—blob-none	Do not use Bloom filters
—coalesce	Use existing commit-graph file to fill commit list
—help	Display help

Parameters:

Parameter	Description
write	Creates or updates the commit graph file
verify	Verifies the commit graph file
read	Prints information about the commit graph file

Caution

Commit graph files are experimental and may change in future Git versions. Manual modification can corrupt the repository.

git commit-graph Command Samples:

Write commit graph file

git commit-graph write

Creates a commit graph file with all reachable commits.

Verify commit graph integrity

git commit-graph verify

Checks if the commit graph file is valid and consistent.

Read commit graph information

git commit-graph read

Displays details about the current commit graph file.

Write with progress reporting

git commit-graph write --progress

Creates commit graph with progress output.

Create incremental commit graph

git commit-graph write --append

Adds new commits to existing commit graph without rewriting.

Use existing graph for new writes

git commit-graph write --coalesce

Utilizes previous commit graph to optimize new graph creation.

Verification with verbose output

git commit-graph verify --progress

Performs thorough verification of commit graph with progress.

Tip

Run git commit-graph write after major operations like merges or rebases for performance. Use git config core.commitGraph true to enable commit graph by default.

How do I create a Git commit graph file?

To create a Git commit graph file, use:

git commit-graph write

How can I verify the commit graph file?

To verify the commit graph file, run:

git commit-graph verify

How do I read commit graph information?

To read commit graph information, execute:

git commit-graph read

How can I append to an existing commit graph?

To append to an existing commit graph, use:

git commit-graph write --append

How do I enable commit graph globally?

To enable commit graph globally, run:

git config --global core.commitGraph true

Applications of the git commit-graph command

1. Improving performance of Git operations in large repositories
2. Optimizing commit history traversal and lookup
3. Reducing time for git log and related commands
4. Supporting large-scale development workflows
5. Enhancing CI/CD pipeline efficiency in monorepos
6. Managing repository performance in enterprise environments