git-pulse

A cross-platform terminal dashboard showing the health of a git repository at a glance.

One command. No setup. Zero dependencies.

What It Shows

| Section | Details | |---|---| | Activity chart | Weekly commit bars for the last 8 weeks, with trend vs previous period | | Top contributors | Who committed the most in the last 30 days, with percentage bars | | Hot files | Files changed most often — your highest-churn code | | Stale branches | Local branches with no commits in 30+ days (cleanup candidates) | | Branch status | Current branch, ahead/behind remote |

Why Not git-quick-stats?

git-quick-stats is a bash script. It doesn't work on Windows without WSL, requires copy-pasting a bash function, and has no npm install. git-pulse is a single Node.js file that installs with npm install -g git-pulse and works everywhere.

Install

npm install -g git-pulse

Or run without installing:

npx git-pulse

Usage

# Dashboard for the current directory
git-pulse

# Dashboard for another repo
git-pulse ./path/to/repo
git-pulse D:/projects/my-app

Example Output

git-pulse  vt2  [master]  since 2024-01-15

ACTIVITY  (last 8 weeks)  ─────────────────────────────
  32 commits in last 30 days  +18% vs prev 30d

  Apr 07   ████░░░░░░░░░░░░░░░░░░░░   6
  Apr 14   ██████░░░░░░░░░░░░░░░░░░   9
  Apr 21   ████████░░░░░░░░░░░░░░░░  12
  Apr 28   ████░░░░░░░░░░░░░░░░░░░░   6
  May 05   ██████████░░░░░░░░░░░░░░  15
  May 12   ████████████░░░░░░░░░░░░  18
  May 19   ████████████████░░░░░░░░  24
  May 26   ████████░░░░░░░░░░░░░░░░  12

TOP CONTRIBUTORS  (last 30 days)  ──────────────────────
  Rushabh Shah           ████████████████░░░   28 (87%)
  GitHub Actions         ██░░░░░░░░░░░░░░░░░    4 (12%)

HOT FILES  (most changed, 30 days)  ────────────────────
  backend/src/routes/auth.ts               ████████   8x
  backend/src/services/db.ts               ██████░░   6x
  frontend/src/App.tsx                     █████░░░   5x
  backend/src/middleware/authMiddleware.ts  ████░░░░   4x

STALE BRANCHES  (no commits in 30+ days)  ──────────────
  feature/old-payment-flow                    87d old
  fix/legacy-auth-v1                          45d old

BRANCH STATUS  ──────────────────────────────────────────
  master  3 ahead  ·  0 behind  (remote last synced: 2 hours ago)

License

MIT

Keywords

git stats · repo dashboard · git activity · contributor stats · git-quick-stats alternative · repository health · commit stats · git insights · cross-platform · zero dependencies

Built to solve, shared to help — Rushabh Shah 🛠️✨

One of 40+ zero-dependency developer CLI tools — no node_modules, ever.