📊 gitstats

Beautiful git statistics in your terminal

✨ Features

• 📈 Commit statistics at a glance
• 🗓️ Activity heatmap by day of week
• ⏰ Peak coding hours analysis
• 🔥 Commit streaks tracking
• 📅 Date range filtering
• 👤 Author filtering
• 👥 Contributor insights
• 🎨 Beautiful terminal output
• 📤 JSON output for scripting

🚀 Installation

pip install gitstats

Or install from source:

git clone https://github.com/mloncarevich/gitstats.git
cd gitstats
pip install -e .

📖 Usage

# Show stats for current directory
gitstats stats

# Show stats for a specific repo
gitstats stats /path/to/repo

# Output as JSON (for scripting)
gitstats stats --json

# Filter by date range
gitstats stats --since 2025-01-01
gitstats stats --since 2025-01-01 --until 2025-12-31

# Filter by author
gitstats stats --author "Milan"

# Show only top N contributors
gitstats stats --top 5

# Combine filters
gitstats stats --author "Milan" --since 2025-01-01 --json

🛠️ Development

# Clone the repo
git clone https://github.com/mloncarevich/gitstats.git
cd gitstats

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install in development mode
pip install -e .

📝 License

MIT License - see LICENSE for details.