📊 git-insights

Analyze git repositories for commit patterns, contributor stats, code churn, and team productivity insights.

Turn your git history into actionable insights. git-insights analyzes commit patterns, identifies code hotspots, calculates bus factor, scores repository health, and generates beautiful reports — all from the command line.

---

✨ Features

Feature	Description
📈 Commit Analytics	Total commits, lines changed, merge ratios, trends
👥 Contributor Stats	Leaderboard with commits, lines, active days per author
🔥 File Hotspots	Identify most churned files (high change + high commits)
📅 Day Distribution	Which days of the week see the most commits
🕐 Hour Heatmap	Activity pattern by hour of day
📊 Monthly Trends	Commit frequency over time with bar charts
🏥 Health Score	0-100 repository health grade (A+ to F)
🚌 Bus Factor	How many contributors cover 50% of commits
📋 File Types	Changes breakdown by file extension
🌐 HTML Reports	Beautiful dark-themed dashboards
📄 JSON Export	Machine-readable output for CI/CD integration
⏰ Time Filtering	Analyze specific date ranges with --since/--until

---

📦 Installation

pip install git-insights-cli

---

🚀 Quick Start

# Full analysis of current repo
git-insights analyze .

# Generate HTML dashboard
git-insights analyze . --html report.html

# Last 6 months only
git-insights analyze . --since "6 months ago"

# Quick summary
git-insights summary .

# Contributor leaderboard
git-insights contributors .

# File hotspots
git-insights hotspots .

# Activity patterns
git-insights activity .

---

📖 Commands

analyze — Full repository analysis

git-insights analyze <PATH> [OPTIONS]

Options:
  --since TEXT   Start date (e.g., '2024-01-01', '6 months ago')
  --until TEXT   End date
  --html PATH    Export HTML dashboard report
  -j PATH        Export JSON report

Generates comprehensive analysis including:

• Summary stats (commits, lines, age, bus factor)
• Top contributors leaderboard
• Day-of-week distribution with bar charts
• Hour-of-day activity heatmap
• File hotspot table (churn score ranking)
• Monthly commit trend
• File type breakdown
• Health score (A+ to F grade)

contributors — Contributor leaderboard

git-insights contributors <PATH> [--top N]

hotspots — Most churned files

git-insights hotspots <PATH> [--top N]

Files with high churn scores (changes × commits) are potential refactoring candidates.

activity — Commit activity patterns

git-insights activity <PATH>

Shows day-of-week distribution and hour-of-day heatmap.

summary — Quick health check

git-insights summary <PATH>

---

🏥 Health Score

The health score (0-100) considers:

Factor	Bonus
3+ contributors	+10
Last commit < 7 days	+15
Last commit < 30 days	+10
Bus factor ≥ 3	+10
≥ 1 commit/day avg	+10
Healthy merge ratio	+5

Grades: A+ (90+), A (80+), B (70+), C (60+), D (50+), F (<50)

---

📊 HTML Dashboard

git-insights analyze . --html report.html

The dark-themed dashboard includes:

• Summary cards — commits, contributors, lines, bus factor, health grade
• Contributor table — ranked by commits with add/delete stats
• Day distribution — bar chart showing weekday vs weekend patterns
• Hour heatmap — 24-hour activity visualization
• File hotspots — most churned files with churn scores
• Monthly trend — commit frequency over time
• File types — changes by extension

---

🔄 CI/CD Integration

JSON Output

git-insights analyze . -j insights.json

Returns structured JSON with all metrics for dashboards or monitoring.

GitHub Actions

- name: Git Insights
  run: |
    pip install git-insights-cli
    git-insights analyze . -j insights.json --html report.html

---

🧪 Development

git clone https://github.com/SanjaySundarMurthy/git-insights.git
cd git-insights
pip install -e ".[dev]"
pytest tests/ -v
ruff check .

---

📋 Requirements

• Python 3.10+
• Git (accessible via command line)
• click >= 8.0
• rich >= 13.0

---

📄 License

MIT License — see LICENSE for details.

---

👤 Author

Sanjay S — GitHub · PyPI

---

🏆 Other Tools

Tool	Description	PyPI
secret-scanner	Credential & secret leak detector	secret-scanner-cli
docker-lens	Dockerfile analyzer & optimizer	docker-lens-cli
yaml-doctor	YAML linter for K8s, Compose, GHA	yaml-doctor-cli