A command-line tool that generates GitHub-like contribution calendars from local git commit history.
git-stats is a Node.js command-line tool that visualizes your local git commit history in a terminal-based calendar format similar to GitHub's contributions graph. It analyzes git repositories on your machine to provide insights into coding activity, independent of external platforms like GitHub. The tool displays commit frequency, author statistics, and supports custom date ranges for flexible analysis.
Developers who want to track and visualize their personal coding activity directly from local git repositories, especially those who work offline, use multiple version control platforms, or prefer privacy over cloud-based analytics. It's also useful for team leads who need to analyze commit contributions within a specific codebase.
Developers choose git-stats because it provides full ownership and control over commit data locally, without relying on GitHub or other external services. Its unique selling point is the ability to generate GitHub-like contribution calendars directly in the terminal, with additional features like author statistics, data import/export, and cross-platform support.
๐ Local git statistics including GitHub-like contributions calendars.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Stores all commit data locally in ~/.git-stats, ensuring privacy and offline access without relying on external services like GitHub, as emphasized in the project's philosophy.
Renders a color-coded contributions calendar directly in the terminal using ANSI colors, closely mimicking GitHub's visual style for immediate, at-a-glance insights.
Provides pie charts showing additions and deletions per author within repositories, enabled by the -S flag, useful for analyzing individual coding efforts.
Allows specifying custom start and end dates for commit analysis using -s and -u options, enabling detailed reports for arbitrary periods beyond the default yearly view.
Only functions correctly on Windows with terminals that support ANSI colors, such as Cygwin, while common options like Command Prompt and Git Bash do not work, limiting cross-platform ease.
Requires running a curl script to initialize git hooks for automatic commit tracking, which can be error-prone or intrusive for users unfamiliar with shell commands.
Importing commits from existing repositories necessitates a separate tool, git-stats-importer, adding an extra step and dependency to build a complete activity timeline.