git-blame-summary-cli

Per-author contribution stats for any file or directory using git blame.

Install

npm install -g git-blame-summary-cli

Usage

git-blame-summary <file|dir> [options]

Options:
  --top <n>        Show only top N authors (default: show all)
  --since <date>   Filter commits after date (e.g. "2024-01-01")
  --json           Output as JSON
  --no-color       Disable colors
  -h, --help       Show this help

Examples

Single file:

git-blame-summary src/index.js

Entire directory:

git-blame-summary src/

Top 5 contributors since 2024:

git-blame-summary . --top 5 --since 2024-01-01

JSON output for scripting:

git-blame-summary src/ --json | jq '.authors[0]'

Sample Output

Git Blame Summary — /path/to/src/index.js
Total lines (matched): 312

AUTHOR            LINES       %  BAR
─────────────────────────────────────────────────────
Alice             210      67.3%  ██████████████████████░░░░░░░░
Bob               72       23.1%  ███████░░░░░░░░░░░░░░░░░░░░░░░
Carol             30        9.6%  ███░░░░░░░░░░░░░░░░░░░░░░░░░░░

Features

• Zero external dependencies — pure Node.js + git blame --porcelain
• Works on single files or entire directories (aggregates all tracked files)
• Filters by commit date with --since
• Color-coded bar chart
• JSON output mode for scripting
• Graceful error handling (non-git repos, binary files, untracked files)

Requirements

• Node.js >= 14
• git available in PATH
• Must be run inside a git repository

License

MIT