Repo reports
Turn a single repository into a navigable HTML report with overview, commits, contributors, charts, quality, and hotspots routes.
Standalone git reports for repos that need receipts.
git-snitch is a Node-based npm CLI that writes self-contained HTML reports for a repository or a recursive scan. No backend, no database, no browser launch unless you ask for --open.
Reports shaped for local evidence, not cloud dashboards.
GeneratearchiveableHTML,inspectrepositoryhealth,comparescans,exportusefuldata,andswaproute-leveltemplateswithoutchangingtheCLIcontract.
Scan reports
Run recursive scans from a directory, compare projects, and drill into each discovered repository without a hosted service.
Custom templates
Pass `--template <path>` to provide route-level TSX overrides while missing routes fall back to the built-in renderer.
Exports
Use report export controls for CSV/JSON data where the standalone renderer has exportable tables and datasets.
Standalone HTML
Each CLI run writes a self-contained report file designed for local sharing, archiving, and file-protocol viewing.
Install it, write a file, choose when to open it.
The v1 CLI exposes only git-snitch repo and git-snitch scan. Output overwrites by default; add --no-overwrite to fail when the target exists.
Install the npm CLI
pnpm add -D git-snitchnpm install --save-dev git-snitchCreate a single-repo report
pnpm exec git-snitch repo --output ./reports/repo.htmlpnpm exec git-snitch repo --openScan multiple repositories
pnpm exec git-snitch scan ../workspace --output ./reports/scan.htmlpnpm exec git-snitch scan ../workspace --max-depth 3Customize or protect output
pnpm exec git-snitch repo --template ./report-template.tsxpnpm exec git-snitch repo --no-overwritereposcan--template--json--open--no-overwritestandalone HTMLreposcan--template--json--open--no-overwritestandalone HTML
Repo fixture
Illustrative fixture placeholder showing overview, contributors, quality signals, and hotspots in one file.
42 commits
5 contributors
87 health
Scan fixture
Illustrative fixture placeholder showing discovered repositories and project drill-down routes.
8 repos
3 branches
CSV export