git-stats

git‑stats is a command‑line utility that generates local GitHub‑style contribution calendars from the commit history of a repository. It reads commits stored in a hidden data file (by default ~/.git‑stats) and can display the activity as a calendar, a pie chart of additions versus deletions, or raw JSON output. The tool supports options for light or dark themes, custom date ranges, author filtering, and different statistics modes, and it can be installed globally via npm.

The program is aimed at developers who want a visual overview of their own or a team’s commit activity without relying on the GitHub service. It also offers a simple way to import existing commit data from other repositories or from GitHub and Bitbucket using the companion git‑stats‑importer utility, allowing users to back‑fill a calendar rather than starting from scratch.

Installation includes an optional script that sets up a post‑commit Git hook to automatically record new commits, and configuration can be customized through a ~/.git‑stats‑config.js file. Documentation and source code are hosted on GitHub.