gritHEAD → docs/performance-overview
Benchmarks / Performance overview (daily matrix)Markdown

Performance overview (daily matrix)

Factory daily census — grit vs git time and peak memory across functional areas.

The factory runs a daily census of common grit workflows against the system git binary on fixed repository shapes. Results land in committed JSON (grit-daily-bench/1) and on the cooking bench dashboard. This page renders the latest committed baseline as a per-area matrix aligned with grit-utils/MATRIX.md.

Methodology

Repository shapes

Scenarios use prepared fixtures under GRIT_BENCH_CACHE (see Benchmarks). Shapes include:

Shape Role
small Tiny synthetic repo for cheap init/commit checks
synth-10k / synth-100k Large synthetic trees (10k / 100k files) with controlled dirty/clean states
git-git Bare and working copies of upstream git.git (tag pinned in the fixture registry)
many-refs / many-refs-loose Many branches/tags for ref-list and pack-refs workloads
big-blobs Few paths with very large blobs (sparse worktree for daily capture on low-memory VMs)
deep-tree Deep directory nesting for status/diff on deep paths

Optional GRIT_BENCH_DAILY_LOW_MEMORY=1 selects smoke-sized special fixtures while keeping the same scenario ids; the committed latest.json baseline on this page was captured with full-size fixtures (see Benchmarking harness for smoke vs full runs).

Run policy

grit-bench daily uses the direct-spawn runner: each timed sample spawns git or grit as a child process, measures wall time for the process lifetime, and records peak resident set size (RSS) for that child and its descendants. On Linux, the monitor polls /proc for the process tree during the run and also reads getrusage(RUSAGE_CHILDREN) when the child exits; the reported peak is the maximum of those observations (bytes). Each tool reports the median wall time and median peak RSS over successful timed runs (default policy: warmups plus at least five timed samples and a minimum aggregated timed window per scenario).

Headline scenarios (headline: true in the report) are the 17 cooking-page rows; they are highlighted in the tables below.

Invocation

$ cargo build --release -p grit-cli -p grit-utils
$ ./target/release/grit-bench fixtures prepare --only synth-10k-smoke,many-refs-smoke,git-git-wt,git-git
$ ./target/release/grit-bench daily --output grit-utils/baselines/daily/latest.json
$ ./target/release/grit-bench daily validate grit-utils/baselines/daily/latest.json

Regenerate the committed census with a full grit-bench daily run (all matrix ids, release binaries, fixtures prepared) and validate before updating grit-utils/baselines/daily/latest.json.

Rows marked Pending or Not in committed daily baseline are exemptions: either blocked on roadmap CLI (see Gaps in MATRIX.md) or not yet present in the committed census file.

Daily matrix (committed baseline)

Git git version 2.43.0
Grit grit 0.5.14
CPU Intel(R) Xeon(R) Processor
OS linux (Linux 6.12.94+)
Recorded 2026-10-21 13:08:19.302252211

Summary by area

Area Scenarios Median Grit / Git (time) Worst Grit / Git (time) Median memory ratio
odb 0 — — —
packs 0 — — —
refs 1 — — —
index 2 1.00× 1.00× 2.08×
worktree 52 1.00× 1.40× 2.26×
diff 5 1.00× 1.00× 2.41×
revwalk 24 1.00× 16.32× 2.44×
blame 2 1.83× 2.66× 2.18×
branching 27 4.66× 4.99× 2.75×
remotes 30 6.79× 35.61× 1.83×
maintenance 5 — — —
config 3 — — —
ignore 1 — — —
hooks 1 — — —
notes 3 — — —
bundles 3 — — —
worktrees 3 — — —

odb

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes

packs

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes

refs

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
gc/pack-refs@synth-10k — — — — — — Not in committed daily baseline

index

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
diff/staged@deep-tree 50.7 50.7 1.00× 7.1 MiB 13.3 MiB 1.86×
diff/staged@synth-100k 50.6 50.7 1.00× 6.1 MiB 14.0 MiB 2.31×

worktree

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
add/all@synth-100k 50.7 50.7 1.00× 6.0 MiB 15.2 MiB 2.53×
add/update@synth-100k — — — — — — Not in committed daily baseline
add/all-ignorecase@synth-100k — — — — — — Not in committed daily baseline
add/update-ignorecase@synth-100k — — — — — — Not in committed daily baseline
add/dry-run@synth-10k — — — — — — Not in committed daily baseline
add/patch-file@synth-10k — — — — — — Not in committed daily baseline
add/hunks@large-file — — — — — — Not in committed daily baseline
add/patch-file@large-file — — — — — — Not in committed daily baseline
add/lines@large-file — — — — — — Not in committed daily baseline
add/modified@big-blobs 50.7 50.7 1.00× 5.1 MiB 11.5 MiB 2.24×
add/modified@synth-10k 50.7 50.7 1.00× 5.1 MiB 12.3 MiB 2.40×
clean/only-ignored@synth-10k — — — — — — Not in committed daily baseline
clean/untracked@synth-10k 50.7 50.7 1.00× 5.2 MiB 10.8 MiB 2.06×
commit/small@small 50.7 50.7 1.00× 5.3 MiB 12.1 MiB 2.29×
commit/small@synth-100k 50.7 50.7 1.00× 6.1 MiB 16.2 MiB 2.64×
commit/small@synth-10k 50.6 50.6 1.00× 5.3 MiB 12.6 MiB 2.40×
commit/staged@synth-100k — — — — — — Not in committed daily baseline
commit/dry-run@synth-10k — — — — — — Not in committed daily baseline
commit/paths@synth-10k — — — — — — Not in committed daily baseline
init/branch@small — — — — — — Not in committed daily baseline
init/empty@small 50.7 50.7 1.00× 5.1 MiB 9.1 MiB 1.77×
mv/file@synth-10k 50.8 50.7 1.00× 5.2 MiB 10.5 MiB 2.00×
reset/hard@synth-10k 50.7 50.7 1.00× 5.3 MiB 12.7 MiB 2.41×
reset/hard-delete-heavy@wide-48k — — — — — — Not in committed daily baseline
reset/keep@synth-10k — — — — — — Not in committed daily baseline
reset/mixed@synth-10k 50.7 50.7 1.00× 5.2 MiB 12.7 MiB 2.43×
reset/sparse@sparse-120k — — — — — — Not in committed daily baseline
reset/sparse@sparse-240k — — — — — — Not in committed daily baseline
reset/sparse@sparse-unique-120k — — — — — — Not in committed daily baseline
reset/undo-commit@git-git — — — — — — Not in committed daily baseline
restore/hunks@large-file — — — — — — Not in committed daily baseline
restore/paths@synth-10k 50.7 50.6 1.00× 5.2 MiB 11.6 MiB 2.24×
rm/dir@synth-10k 50.7 50.7 1.00× 5.3 MiB 11.9 MiB 2.26×
rm/dry-run@synth-10k — — — — — — Not in committed daily baseline
stash/pop-sparse@wide-120k — — — — — — Not in committed daily baseline
stash/pop-index@synth-10k — — — — — — Not in committed daily baseline
stash/push-paths@synth-10k — — — — — — Not in committed daily baseline
stash/push-pop@synth-10k 251 352 1.40× 16.6 MiB 25.3 MiB 1.52×
status/clean@deep-tree 101 101 1.00× 8.6 MiB 17.3 MiB 2.00×
status/clean@small 50.7 50.7 1.00× 5.2 MiB 11.6 MiB 2.21×
status/clean@synth-100k 50.7 50.7 1.00× 6.0 MiB 14.9 MiB 2.46×
status/clean@synth-10k 50.7 50.7 1.00× 5.2 MiB 12.1 MiB 2.31×
status/dirty@deep-tree 101 101 1.00× 8.7 MiB 17.3 MiB 1.98×
status/dirty@small 50.7 50.7 1.00× 5.2 MiB 11.7 MiB 2.23×
status/dirty@synth-100k 50.7 50.7 1.00× 6.1 MiB 14.9 MiB 2.43×
status/dirty@synth-10k 50.7 50.7 1.00× 5.3 MiB 12.3 MiB 2.33×
status/paths@synth-100k — — — — — — Not in committed daily baseline
status/renamed@synth-10k — — — — — — Not in committed daily baseline
switch/branch@synth-10k 50.7 50.6 1.00× 7.9 MiB 15.3 MiB 1.95×
switch/sparse@sparse-120k — — — — — — Not in committed daily baseline
switch/sparse@sparse-240k — — — — — — Not in committed daily baseline
switch/sparse@sparse-unique-120k — — — — — — Not in committed daily baseline

diff

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
diff/worktree@big-blobs 50.7 50.7 1.00× 5.2 MiB 11.8 MiB 2.26×
diff/worktree@deep-tree 50.8 50.7 1.00× 6.5 MiB 14.8 MiB 2.27×
diff/worktree@synth-100k 50.6 50.6 1.00× 6.0 MiB 15.5 MiB 2.59×
diff/worktree@synth-10k 50.7 50.7 1.00× 7.3 MiB 18.6 MiB 2.56×
diff/stat@synth-100k — — — — — — Not in committed daily baseline

revwalk

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
cat/blob@git-git 50.7 50.7 1.00× 5.2 MiB 29.9 MiB 5.70×
log/all@git-git 50.8 829 16.32× 17.9 MiB 121.4 MiB 6.80×
log/oneline-100@git-git 50.7 50.7 1.00× 12.2 MiB 31.2 MiB 2.55×
log/json-100@git-git — — — — — — Not in committed daily baseline
log/json-filter@git-git — — — — — — Not in committed daily baseline
log/json-n10-loose-tags@git-git — — — — — — Not in committed daily baseline
log/json-n10-packed-tags@git-git — — — — — — Not in committed daily baseline
log/stat-n50@git-git — — — — — — Not in committed daily baseline
log/oneline-100@synth-100k 50.7 50.7 1.00× 5.4 MiB 12.5 MiB 2.33×
log/limit-path@git-git — — — — — — Not in committed daily baseline
log/path@git-git 352 2,510 7.14× 247.2 MiB 309.1 MiB 1.25×
merge-base/branches@git-git 50.8 653 12.85× 16.8 MiB 59.0 MiB 3.51×
patch-id/commit@git-git 50.6 50.6 1.00× 6.6 MiB 31.1 MiB 4.73×
reflog/list@synth-10k 50.7 50.7 1.00× 5.2 MiB 9.5 MiB 1.82×
resolve/head-n@git-git 50.7 50.7 1.00× 5.2 MiB 31.0 MiB 5.94×
resolve/change-id@git-git — — — — — — Not in committed daily baseline
revs/count@git-git 552 753 1.36× 59.2 MiB 119.3 MiB 2.02×
revs/count-path@git-git — — — — — — Not in committed daily baseline
revs/count-range-commit-graph@git-git — — — — — — Not in committed daily baseline
shortlog/ahead@git-git 50.7 50.7 1.00× 16.9 MiB 9.9 MiB 0.59×
shortlog/behind@git-git — — — — — — Not in committed daily baseline
show/head@big-blobs 50.7 50.6 1.00× 10.6 MiB 16.2 MiB 1.52×
show/head@git-git 50.6 50.6 1.00× 6.6 MiB 31.0 MiB 4.69×
show/head@synth-10k 50.7 50.7 1.00× 6.5 MiB 14.3 MiB 2.20×

blame

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
blame/file@deep-tree 50.7 50.7 1.00× 7.5 MiB 13.3 MiB 1.77×
blame/file@git-git 302 804 2.66× 231.1 MiB 599.1 MiB 2.59×

branching

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
branch/create@many-refs — — — — — — Not in committed daily baseline
branch/delete@many-refs — — — — — — Not in committed daily baseline
branch/rename@many-refs — — — — — — Not in committed daily baseline
branch/list@many-refs 50.7 50.6 1.00× 5.1 MiB 9.7 MiB 1.90×
branch/list-json@many-refs — — — — — — Not in committed daily baseline
branch/list@many-refs-loose — — — — — — Not in committed daily baseline
branch/merged@many-refs — — — — — — Not in committed daily baseline
branch/contains@git-git-10k-refs — — — — — — Not in committed daily baseline
branch/contains-json@git-git-10k-refs — — — — — — Not in committed daily baseline
branch/merged-ref@many-refs — — — — — — Not in committed daily baseline
history/reword@synth-10k — — — — — — Not in committed daily baseline
merge/content-both-sides@wide-20k — — — — — — Not in committed daily baseline
merge/clean@synth-100k — — — — — — Not in committed daily baseline
merge/clean@synth-10k 151 753 4.99× 8.7 MiB 24.1 MiB 2.75×
pick/one@synth-100k — — — — — — Not in committed daily baseline
pick/one@synth-10k 151 704 4.66× 8.8 MiB 24.5 MiB 2.80×
rebase/onto@synth-10k — — — — — — Not in committed daily baseline
rebase/onto@git-git — — — — — — Not in committed daily baseline
revert/one@synth-10k — — — — — — Not in committed daily baseline
stash/list@synth-10k — — — — — — Not in committed daily baseline
switch/branch@synth-100k — — — — — — Not in committed daily baseline
switch/delete-heavy@wide-48k — — — — — — Not in committed daily baseline
switch/large-blob@big-asset — — — — — — Not in committed daily baseline
tag/contains@git-git — — — — — — Not in committed daily baseline
tag/create@many-refs — — — — — — Not in committed daily baseline
tag/list-sort-version@git-git — — — — — — Not in committed daily baseline
tag/list@many-refs — — — — — — Not in committed daily baseline

remotes

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
clone/http@synth-10k 1,609 2,011 1.25× 34.6 MiB 51.2 MiB 1.48×
clone/local@synth-10k 1,005 6,824 6.79× 69.3 MiB 114.4 MiB 1.65×
clone/full@git-git — — — — — — Not in committed daily baseline
clone/bare@synth-10k — — — — — — Not in committed daily baseline
clone/checkout@synth-100k — — — — — — Not in committed daily baseline
clone/shallow@git-git — — — — — — Not in committed daily baseline
clone/blobless@git-git — — — — — — Not in committed daily baseline
reset/blobless@git-git — — — — — — Not in committed daily baseline
clone/shallow-depth1@synth-10k — — — — — — Not in committed daily baseline
clone/shallow-depth1-http@synth-10k — — — — — — Not in committed daily baseline
fetch/incremental-http@git-git 76,754 78,655 1.02× 134.4 MiB 82.2 MiB 0.61×
fetch/deepen@git-git — — — — — — Not in committed daily baseline
fetch/dry-run@git-git — — — — — — Not in committed daily baseline
fetch/incremental@git-git 151 1,807 11.96× 52.9 MiB 125.1 MiB 2.37×
fetch/one-branch@git-git — — — — — — Not in committed daily baseline
fetch/noop@git-git 50.7 1,807 35.61× 32.8 MiB 103.7 MiB 3.16×
fetch/noop-local@many-refs — — — — — — Not in committed daily baseline
fetch/noop-local-no-tags@many-refs — — — — — — Not in committed daily baseline
ls-remote/all@many-refs 50.7 50.7 1.00× 8.4 MiB 15.3 MiB 1.83×
remote/show@many-refs — — — — — — Not in committed daily baseline
remote/rename@many-refs — — — — — — Not in committed daily baseline
pull/fast-forward@git-git 151 1,907 12.63× 57.2 MiB 145.3 MiB 2.54×
pull/rebase@synth-10k — — — — — — Not in committed daily baseline
pull/check@git-git — — — — — — Not in committed daily baseline
push/incremental-http@git-git 1,708 12,748 7.46× 305.6 MiB 2022.4 MiB 6.62×
push/refspec@git-git — — — — — — Not in committed daily baseline
push/incremental@git-git 1,607 50.7 0.03× 184.3 MiB 40.8 MiB 0.22×
push/force-with-lease@git-git — — — — — — Not in committed daily baseline
remote/list@small — — — — — — Not in committed daily baseline
remote/remove@many-refs — — — — — — Not in committed daily baseline

maintenance

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
fsck/full@big-blobs — — — — — — Not in committed daily baseline
fsck/full@git-git — — — — — — Not in committed daily baseline
gc/default@synth-10k — — — — — — Not in committed daily baseline
repack/commit-graph@git-git — — — — — — Not in committed daily baseline
repack/full@git-git — — — — — — Not in committed daily baseline

config

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
config/get@small — — — — — — Not in committed daily baseline
config/get-origin@small — — — — — — Not in committed daily baseline
config/set@small — — — — — — Not in committed daily baseline

ignore

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
ignore/check-1000@synth-10k — — — — — — Not in committed daily baseline

hooks

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
hooks/list@small — — — — — — Not in committed daily baseline

notes

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
notes/add@synth-10k — — — — — — Not in committed daily baseline
notes/list@synth-10k — — — — — — Not in committed daily baseline
notes/list-n100@synth-10k — — — — — — Not in committed daily baseline

bundles

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
bundle/create@synth-10k — — — — — — Not in committed daily baseline
bundle/create-all@git-git — — — — — — Not in committed daily baseline
bundle/verify@synth-10k — — — — — — Not in committed daily baseline

worktrees

Scenario Git median (ms) Grit median (ms) Time Git peak RSS Grit peak RSS Memory Notes
worktree/add@synth-10k — — — — — — Not in committed daily baseline
worktree/list@synth-10k — — — — — — Not in committed daily baseline
worktree/remove@synth-10k — — — — — — Not in committed daily baseline