gitstats-cli 0.1.0

Git repository statistics and summaries for humans and AI agents

gitstats-cli

Git repository statistics for humans and AI agents. One command to understand any repo.

Install

pip install gitstats-cli

Usage

# Repository overview
gitstats summary .

# Contributors ranked by commits
gitstats authors .

# Commit activity (last 30 days)
gitstats activity . --days 30

# File breakdown by extension
gitstats files .

# Recent commits
gitstats log . -n 10

# Most frequently changed files (churn)
gitstats churn .

# Code ownership by author (line count)
gitstats blame .
gitstats blame . --file src/main.py

Every command supports --json for machine-readable output.

Commands

Command	Description
summary	Branch, commits, contributors, tags, dirty state
authors	Contributors ranked by commit count
activity	Commit frequency over time with bar chart
files	Tracked files grouped by extension
log	Recent commits (hash, date, author, message)
churn	Most frequently changed files
blame	Code ownership by line count per author

For AI Agents

See SKILL.md for agent-optimized documentation with patterns and JSON output specs.

License

MIT