git-stats-cli

Beautiful git repository statistics and contributor analysis right from your terminal.

Install

npm install -g git-stats-cli

Usage

# Run inside any git repository
git-stats summary          # Repository overview
git-stats authors          # Contributor rankings
git-stats timeline         # Commit frequency chart
git-stats files            # Most modified files
git-stats hours            # Activity by hour of day

Global Options

| Flag | Description | |------|-------------| | -d, --dir <path> | Path to git repository (default: cwd) | | --since <date> | Filter commits after date | | --until <date> | Filter commits before date | | --author <name> | Filter by author name | | --json | Output raw JSON |

Commands

summary - Total commits, contributors, first/last commit dates, active days, tracked files, branches, and tags.

authors - Ranked list of contributors with commit count, lines added, lines deleted, and a visual bar chart.

timeline - Commit frequency grouped by day, week, or month with ASCII bar charts.

git-stats timeline -p month    # Group by month
git-stats timeline -p day      # Group by day

files - Most frequently changed files, ranked by number of commits that touched them.

git-stats files -l 10          # Top 10 files

hours - Heatmap-style display of commit activity by hour of day, colored by intensity.

Examples

# Stats for a specific repo
git-stats summary -d /path/to/repo

# Commits in the last 30 days
git-stats authors --since="30 days ago"

# Single author's timeline
git-stats timeline --author="Alice" -p day

# JSON output for scripting
git-stats summary --json | jq .totalCommits

License

MIT