Metadata-Version: 2.4
Name: gitstats-cli
Version: 0.1.0
Summary: Git repository statistics and summaries for humans and AI agents
Author-email: Marcus <marcus.builds.things@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/gitstats
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/gitstats/issues
Keywords: git,statistics,cli,devtools,agent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Dynamic: license-file

# gitstats-cli

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

## Install

```bash
pip install gitstats-cli
```

## Usage

```bash
# 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](SKILL.md) for agent-optimized documentation with patterns and JSON output specs.

## License

MIT
