git-contrib-stats
| Crates.io | git-contrib-stats |
| lib.rs | git-contrib-stats |
| version | 0.4.2 |
| created_at | 2025-12-10 05:47:11.949405+00 |
| updated_at | 2025-12-18 06:11:42.015535+00 |
| description | CLI tool to generate git commit statistics per contributor |
| homepage | |
| repository | https://github.com/CharlonTank/git-contrib-stats |
| max_upload_size | |
| id | 1977543 |
| size | 44,105 |
(CharlonTank)
documentation
README
git-contrib-stats
CLI tool to generate git commit statistics per contributor with optional GitHub-style HTML reports.
Installation
cargo install git-contrib-stats
Usage
git-contrib-stats [OPTIONS]
Options
| Option | Description |
|---|---|
-b, --branch <BRANCH> |
Branch to analyze (default: current branch) |
-s, --since <DATE> |
Start date (e.g., 2025-01-01) |
-u, --until <DATE> |
End date (e.g., 2025-12-31) |
-m, --merge <MAPPING> |
Merge authors (format: Alias1,Alias2,... into first name) |
--html |
Generate an HTML report with interactive charts |
--open [APP] |
Open the HTML report in browser (optionally specify app: Safari, Chrome, Firefox) |
Examples
Basic usage:
git-contrib-stats -b main
Merge multiple author aliases:
git-contrib-stats \
-m "John,john.doe,JohnD" \
-m "Jane,jane_smith"
Generate HTML report and open in Safari:
git-contrib-stats --html --open Safari
Terminal Output
Branch: main
| Contributor | Commits | Lines added | Lines deleted | % |
|--------------|----------|-------------|---------------|--------|
| John | 142 | 15234 | 8721 | 51.8% |
| Jane | 87 | 9876 | 4532 | 31.8% |
| Bob | 45 | 3210 | 1234 | 16.4% |
|--------------|----------|-------------|---------------|--------|
| TOTAL | 274 | 28320 | 14487 | 100% |
HTML Report
When using --html, generates a contrib-report.html file featuring:
- Stacked area chart showing all contributors over time
- Individual contributor charts with commit history
- Period toggles: 1 Day, 3 Days, 1 Week, 1 Month, 1 Year
- Interactive tooltips with commit counts
- GitHub dark theme styling
License
MIT