📊 gitdash

Beautiful GitHub repo analytics right in your terminal

✨ Features

• ⭐ Star count & trend — Track stars gained in the last 7 and 30 days
• 🍴 Fork count — See repository fork statistics
• 🐛 Open issues — Current issue count at a glance
• 📝 Recent commits — Latest 10 commits with authors
• 👥 Top contributors — See who's driving the project
• 📊 Language breakdown — Visual bar chart of languages used
• 📈 Commit frequency — Average commits per day over 4 weeks
• 📦 Releases — Latest release tags and dates
• ⚔️ Repo comparison — Compare two repos side-by-side
• 📤 JSON export — Export all stats to a JSON file
• 🎨 Rich terminal UI — Colorful, beautiful output powered by Rich

🚀 Installation

# Install from source
git clone https://github.com/zehedisode/gitdash.git
cd gitdash
pip install .

# Or install directly with pip
pip install git+https://github.com/zehedisode/gitdash.git

📖 Usage

Basic Usage

# View dashboard for any public repo
gitdash owner/repo

# Examples
gitdash textualize/rich
gitdash fastapi/fastapi
gitdash python/cpython

Compare Repos

# Compare two repositories side-by-side
gitdash fastapi/fastapi --compare flask/flask

Export to JSON

# Export stats to a JSON file
gitdash owner/repo --export stats.json

Authentication (Optional)

gitdash works without authentication using GitHub's public API (rate limited to 60 requests/hour).

For higher rate limits, set a GitHub token:

export GITHUB_TOKEN=ghp_your_token_here
gitdash owner/repo

You can create a personal access token at GitHub Settings → Developer settings → Personal access tokens.

🖥️ Example Output

────────────────── 📊  textualize/rich ──────────────────

┌─── Overview ────────────────────────────────────────┐
│  ⭐  Stars          50,234                           │
│  🍴  Forks          3,821                            │
│  🐛  Open Issues    128                              │
│  👀  Watchers       412                              │
│  📐  License        MIT                              │
│  🏷️  Default Branch  main                            │
│  📅  Created        2019-07-13                       │
│  🔄  Last Push      2025-05-01                      │
└──────────────────────────────────────────────────────┘

┌─── ⭐ Star Trend ───────────────────────────────────┐
│  Last 7 days:  +234 stars                            │
│  Last 30 days: +1,023 stars                          │
│  Total:        50,234                                │
└──────────────────────────────────────────────────────┘

┌─── 📊 Languages ────────────────────────────────────┐
│  Python             ██████████████████  95.2%        │
│  Rich               ███                3.1%          │
│  MDX                █                  1.7%          │
└──────────────────────────────────────────────────────┘

🛠️ Requirements

• Python 3.10+
• Internet connection (for GitHub API)

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

Made with ❤️ by zehedisode