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