git-stats is a Node.js command-line tool and library for tracking Git activity locally. It renders commit history as an ANSI contribution calendar similar to the graph displayed on GitHub profiles. Users can select custom date ranges, display global activity, filter commits by author, and compare additions with deletions. Author statistics can also be presented as terminal pie charts. Commit records are stored in a configurable local data file, with a JavaScript configuration file controlling themes and default behavior. A post-commit hook can record future work automatically, while companion importers can add existing repository history. Raw JSON output allows other tools to create HTML pages, images, or custom visualizations.
Features
- GitHub-style terminal contribution calendars
- Custom activity date ranges
- Author contribution filtering
- Addition and deletion statistics
- Automatic post-commit recording
- Raw JSON data export