beautiful-git-stats 1.0.0

Beautiful Git repository statistics and insights in your terminal

🚀 Git Stats CLI

Beautiful Git repository statistics and insights right in your terminal ✨

Get instant insights into your Git repositories with gorgeous, colorful terminal output. Perfect for developers, team leads, and anyone who wants to understand their codebase better.

🎯 Features

• 📊 Repository Summary - Total commits, authors, files, and line changes
• 👥 Top Contributors - See who's contributing the most
• 🔥 Hotspots - Find the most frequently changed files
• 📅 Activity Patterns - Discover when your team is most active
• 🎨 Beautiful Output - Rich, colorful terminal UI
• ⚡ Fast & Lightweight - Analyze repos in seconds
• 🔍 Flexible Filtering - Filter by author, date range, and more

📦 Installation

Via pip (Recommended)

pip install beautiful-git-stats

From source

git clone https://github.com/serimoth/beautiful-git-stats.git
cd beautiful-git-stats
pip install -e .

🚀 Quick Start

# Show repository summary
git-stats summary

# Show top 10 contributors
git-stats contributors

# Show most changed files (hotspots)
git-stats hotspots

# Show activity patterns by day and hour
git-stats activity

📖 Usage Examples

Repository Summary

Get a quick overview of your repository:

git-stats summary /path/to/repo

Output:

┌─────────────────────────────────────┐
│      📊 Repository Summary          │
├─────────────────┬───────────────────┤
│ Total Commits   │ 1,234             │
│ Total Authors   │ 15                │
│ Total Files     │ 456               │
│ Lines Added     │ +45,678           │
│ Lines Deleted   │ -12,345           │
│ First Commit    │ 2023-01-15        │
│ Last Commit     │ 2026-05-20        │
│ Active Days     │ 234               │
└─────────────────┴───────────────────┘

Filter by Author

git-stats summary --author "John Doe"

Filter by Date Range

git-stats summary --since 2026-01-01 --until 2026-05-20

Top Contributors

See who's contributing the most:

git-stats contributors --limit 5

Find Hotspots

Identify files that change frequently (potential refactoring candidates):

git-stats hotspots --limit 10

Activity Patterns

Understand when your team is most productive:

git-stats activity

🎨 Screenshots

🛠️ Advanced Usage

Analyze Multiple Repositories

for repo in ~/projects/*; do
  echo "Analyzing $repo"
  git-stats summary "$repo"
done

Export to JSON (Coming Soon)

git-stats summary --format json > stats.json

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. 🐛 Report bugs
2. 💡 Suggest new features
3. 🔧 Submit pull requests
4. 📖 Improve documentation
5. ⭐ Star this repo if you find it useful!

Development Setup

git clone https://github.com/serimoth/beautiful-git-stats.git
cd beautiful-git-stats
pip install -e ".[dev]"
pytest

💖 Support This Project

If you find Git Stats CLI useful, consider supporting its development:

• ⭐ Star this repository
• 🐦 Share on Twitter
• ☕ Support on Ko-fi

Your support helps maintain and improve this tool!

📝 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

Built with:

• GitPython - Git repository interaction
• Rich - Beautiful terminal output
• Click - CLI framework

📬 Contact

• GitHub: @serimoth
• Email: [e-mail]

---

Made with ❤️ by developers, for developers