GitBrag is a command-line tool designed to help users share commit statistics from their local Git repositories efficiently. This tool provides a seamless experience in analyzing and visualizing commit data in various customizable formats.

Key Features

• Comprehensive Commit Statistics: Easily generate visual representations of commit stats for any local Git repository.
• Custom Output Options: Users can output statistics to PNG files with options to customize background and foreground colors, enhancing visual appeal.
• Date Range Filtering: Focus on specific time frames by filtering commits based on start and end dates.
• Author-Specific Stats: Analyze commit contributions by specific authors or emails to understand individual contributions.
• Language Breakdown Visualization: Use the --lang flag to include a visual bar chart showing the percentage breakdown of up to three programming languages used in the commits. This feature provides insights into project language distribution at a glance.
• Exclusion Patterns: With regular expression support, it is possible to exclude files and directories such as node_modules, vendor, or any other files not relevant to the commit statistics.

Usage Examples

Generate commit statistics with the following command:

gitbrag ./ --since '2025-01-01' --author 'john@example.com' -O stats.png -B 000 -C fff

Filter commits by date:

gitbrag ./ --since 2024-01-01 --until 2024-12-31

Output statistics to a PNG file with custom colors:

gitbrag ./ -O stats.png -B fff -C 000

Examine contributions over a specific date range while excluding certain files:

gitbrag ./ --since '2025-09-01' --exclude-files '.*package-lock.json$'

Conclusion

GitBrag is a powerful tool for developers looking to analyze their Git contributions in a clear, visual format. Whether highlighting individual contributions or monitoring overall project activity, GitBrag provides essential insights that can help in managing projects and demonstrating developer impact.