Git Metrics Dashboard

Turn your Git history into a repository health score — risk detection, refactor radar, contributor analytics, and exportable team reports. No login. No cloud upload. Local-first.

English | 한국어 | 日本語 | 简体中文

✨ Key Features

📈 Dashboard Analytics

• 🧠 Repository Command Center (v0.2.4) — one-screen repository health score based on momentum, churn, commit quality, collaboration, and branch hygiene
• 🌿 Branch-scoped analytics (v0.2.4) — select a local branch and recalculate health, churn, contributors, and reports for that branch
• 🔀 Base Branch Comparison (v0.2.4) — see ahead/behind commits and PR-sized diff stats against main, master, or develop
• 🎯 Recommended Next Moves (v0.2.4) — prioritized, actionable suggestions generated from real repository signals
• 🔥 Refactor Radar (v0.2.4) — highlights high-risk files by combining churn, commit frequency, and change volume
• 📋 Copy Brief (v0.2.4) — copy a standup-ready health summary with next actions and refactor candidates
• 📅 Commit Calendar Heatmap (v0.2.3) — GitHub-style 16-week activity grid with 5 color intensity levels
• 🏆 Top 3 Contributor Podium (v0.2.3) — Gold/Silver/Bronze podium above the author ranking list
• 📋 Copy Summary (v0.2.3) — One-click clipboard copy of a formatted stats summary
• Commit Streak — current and longest consecutive commit streak with activity rate
• Week-over-Week Trend — compare commit volume between first and second half of the period (▲▼ indicator)
• Conventional Commits Analysis — compliance rate for feat/fix/chore/docs/etc. with donut chart
• Branch Status — current branch name, total and active branch counts
• Real-time Git Statistics — total commits, file changes, contributor metrics
• Real-time Change Detection — auto-refresh dashboard on commits, branch switches, and file staging
• Interactive Charts — Chart.js-powered visualizations
• Contributor Rankings — contribution metrics and activity patterns per author
• File Type Analysis — support for 70+ programming languages
• Time-based Analysis — hourly and daily activity heatmaps
• Achievement Badges — gamification system with 20+ badges across 5 rarity tiers (including 3 new EPIC badges in v0.2.3)
• Smart Themes — full dark / light / auto theme support
• Polished Responsive UI — modern command center, insight cards, quick navigation, and mobile-friendly dashboard layout

📄 Report Export

• Multiple Formats: HTML, JSON, CSV, Markdown
• Command Center Reports: health score, risk signals, next moves, and refactor candidates are included in exported reports
• Branch-aware Reports: quick and custom exports can target a selected branch
• Theme Integration: VS Code theme automatically applied to HTML reports
• Customizable: choose analysis period, format, and which sections to include
• Badge Integration: achievement badges included in reports
• Professional Quality: suitable for team presentations and documentation

🏢 Commercial Readiness

• Local-first privacy model: repository data is analyzed locally and is not uploaded by the extension
• Security-aware exports: CSV formula injection mitigation and local report output paths
• Adoption documents: bundled Privacy, Security, and Support guides available from the Command Palette
• Executive reporting: Command Center insights are exportable for standups, reviews, and stakeholder updates
• Lean package: no runtime node_modules payload in the VSIX after dependency cleanup

🚀 Installation

Quickest way — opens VS Code directly:

Or manually:

1. Open VS Code → press Ctrl+Shift+X
2. Search "Git Metrics Dashboard"
3. Click Install
4. Open any Git repository in your workspace

📋 Usage

Open Dashboard

Export Reports

Switch Theme

• Status bar theme button: 🔄 Auto / ☀️ Light / 🌙 Dark
• Keyboard: Ctrl+Shift+G → Ctrl+Shift+T

📊 Report Formats

Reports are saved to <workspace>/git-metrics-reports/ by default (configurable).

⚙️ Configuration

{
  "gitMetrics.defaultPeriod": 30,
  "gitMetrics.maxTopFiles": 10,
  "gitMetrics.theme": "auto",
  "gitMetrics.language": "auto",
  "gitMetrics.autoRefresh": false,
  "gitMetrics.autoRefreshInterval": 5000,
  "gitMetrics.showChangeNotification": false,
  "gitMetrics.export.defaultFormat": "html",
  "gitMetrics.export.useThemeInReports": true,
  "gitMetrics.export.autoOpenAfterExport": false,
  "gitMetrics.export.customReportsPath": ""
}

🎯 Use Cases

Team Leads / Managers

• Get an instant repository health score before standups or reviews
• Spot delivery, ownership, and branch hygiene risks without reading raw Git logs
• Analyze per-contributor metrics and velocity
• Generate monthly / quarterly reports
• Monitor project progress and code health

Individual Developers

• Identify refactoring candidates from the Refactor Radar
• Use Recommended Next Moves to decide what to clean up next
• Track personal coding activity and streaks
• Analyze your technology stack usage
• Understand your commit patterns and productivity peaks

Project Management

• Convert Git activity into clear health and risk signals
• Codebase health overview
• Identify technical debt hotspots
• Optimize resource allocation

👥 Install for Your Team

Add Git Metrics Dashboard to your project's recommended extensions so every teammate gets a VS Code install prompt when they open the repository.

1. Create or edit .vscode/extensions.json in your project root:

{
  "recommendations": ["jiwan-dev.git-metrics-dashboard"]
}

2. Commit and push. When a teammate opens the project, VS Code will suggest installing Git Metrics Dashboard automatically.

Or, inside the dashboard, click 🤝 Share with Team to copy the snippet to your clipboard.

🔧 Commands

🛠️ Troubleshooting

Sidebar shows "There is no data provider" or commands are not found

1. Ensure you are on VS Code 1.85.0 or later
2. Run Developer: Reload Window from the Command Palette
3. If the issue persists, open a folder (File → Open Folder) containing a Git repository

Dashboard shows no data

1. Confirm the workspace contains a Git repository (git status)
2. Check that commits exist within the selected period
3. Try increasing gitMetrics.defaultPeriod

Copy Summary button does nothing

1. Check that the VS Code clipboard API is available (some restricted environments block it)
2. Verify clipboard permissions on your OS

Report export fails

1. Verify write permissions on the workspace folder
2. Try setting a custom path via gitMetrics.export.customReportsPath
3. Restart VS Code with administrator privileges if needed

Charts not rendering

1. Restart VS Code (Developer: Reload Window)
2. Check VS Code version ≥ 1.85.0

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m 'feat: add my feature'
4. Push: git push origin feature/my-feature
5. Open a Pull Request

Bug reports and feature requests: GitHub Issues

📄 License

MIT License — see LICENSE for details.

⭐ If this extension is useful, please star it on GitHub and leave a review on the VS Code Marketplace!