repoviz

Visualize a git repo's history over time with pretty charts.

npx repoviz           # run in the current git repo
npx repoviz /path     # or point at any local repo

It walks the main branch (default: last year, one week per sample), snapshots line counts and commit activity, then opens a local web UI.

Flags

• --months <n> — how far back to walk (default 12)
• --bucket-days <n> — days aggregated per bar (default 7; try 1 for per-day granularity)
• --port <n> — server port (default random)
• --no-open — don't auto-open the browser
• --keep-workspace — leave the temp clone under /tmp for debugging

What gets measured

• Commits per day on the main branch — total and by the current git user (git config user.email)
• Lines of source code (.ts .tsx .js .jsx .py .rb .go .rs ...)
• Lines of config (.json .yaml .toml ...)
• Lines of docs (.md .mdx .rst ...)

Files ignored by the repo's own .gitignore are automatically excluded — repoviz works off git ls-files.

How it works

1. git clone --local the target into /tmp/repoviz-* (hardlinks — fast and safe; your working tree is never touched).
2. For each day in the window, find the last main-branch commit ≤ end-of-day, check it out, count tracked lines by category.
3. Commit counts come from a single git log pass.
4. Serve the prebuilt React UI locally and stream the report to it.