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
1 maintainer
Release files for gitstats-cli 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gitstats_cli-0.1.0.tar.gz | 6.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gitstats_cli-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.8 kB
Release files / gitstats_cli-0.1.0.tar.gz
| Download URL | gitstats_cli-0.1.0.tar.gz |
|---|---|
| Size | 6.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb850109de5cd8c71abf57518d6c4d6cfd72537489d0788f8a417f40892a4385
|
|
BLAKE2b-256 checksum How to use checksums |
50cd8aece746fa559044064638fe84cf98238347f614059c65f73aa4e22cbadc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
Release files / gitstats_cli-0.1.0-py3-none-any.whl
| Download URL | gitstats_cli-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac641d394ab178a8fc9d7b41b343a946ae719d7d9cfe6d21f49b635fd7bdddad
|
|
BLAKE2b-256 checksum How to use checksums |
10d8771c4f0c39359af6996851d2a0c08d81e1fd580e719a70f8daccf3fa306f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.2
|
