Your repo's health,
one command away.
Commit velocity. Bus factor. Stale dependencies. Issue half-life. One run gives you the honest numbers — and badge-ready SVG + JSON for your README.
$ repo-pulse repository: your-project (main) commit velocity : 7.3/week avg over 12w (trend up) bus factor : 2 (low) across 6 contributors stale deps : 1/14 older than 12m issue half-life : 4.5 days median time-to-close score : 78/100 (grade B)
Four metrics that actually matter
No vanity charts. The numbers that predict whether a repository is thriving or quietly rotting.
Commit velocity
Average commits per week over a trailing window, with an up/down/flat trend that compares the recent half to the older half. Merges excluded.
Bus factor
The smallest set of contributors covering half of all work. A score of 1 means one resignation away from an orphaned project.
Stale dependencies
Runtime and dev deps whose packages haven't published in over a year — checked against the live npm registry, flagged by name and age.
Issue half-life
Median time from opened to closed across recent GitHub issues. The single best proxy for whether a backlog is being worked or ignored.
Running in 30 seconds
Nothing to configure. Nothing leaves your machine unless you want it to.
Install
npm i -g @stealth-alpha/repo-pulse
Or use npx @stealth-alpha/repo-pulse@latest. No config files required.
Snapshot
cd your-project && repo-pulse
A readable summary plus a 0–100 score with letter grade.
Badge
repo-pulse badge
Writes self-contained SVGs and shields.io endpoint JSON to .repo-pulse/.
Automate
repo-pulse --format json --write
Pipe the JSON anywhere; regenerate badges in CI so they never go stale.
Repo Pulse Pro
For teams maintaining more repositories than they can watch.
- Multi-repo batch snapshots into one aggregated dashboard file
- Scheduled CI regeneration — badges that never go stale
- Trend history: see health improving or drifting month over month
- Custom scoring profiles tuned to your team's definition of "healthy"
- Priority support