Git Stats#

Analyze any local git repository for contributor rankings, LOC by language, commit activity patterns, and monthly trends.

Quick Start#

bash

# Analyze current repo
python3 scripts/git_stats.py

# Analyze a specific repo
python3 scripts/git_stats.py /path/to/repo

# JSON output for further processing
python3 scripts/git_stats.py --json

# Filter by date range
python3 scripts/git_stats.py --since 2025-01-01 --until 2025-12-31

# Specific branch
python3 scripts/git_stats.py --branch main

# Skip LOC counting for faster results
python3 scripts/git_stats.py --no-loc

Output Sections#

• Top Contributors — ranked by commit count with email
• Lines of Code — total files/lines, broken down by extension
• File Types — file count by extension
• Activity by Day — which days of the week get the most commits
• Activity by Hour — peak coding hours
• Monthly Trend — commit volume over the last 12 months (configurable with --months)

Options#

FlagDescription--branchAnalyze a specific branch--sinceOnly include commits after this date--untilOnly include commits before this date--months NMonthly trend window (default: 12)--jsonOutput as JSON for programmatic use--no-locSkip line counting (much faster on large repos)

Dependencies#

• git CLI (must be on PATH)
• Python 3.8+ (stdlib only, no pip packages needed)