Hotspot is an agentic intelligence layer and CLI that analyzes Git history to diagnose technical debt and bus factor risk based on developer activity, ownership, and churn patterns.
Unlike traditional linters or team-velocity metrics, Hotspot analyzes development behavior. It turns Git metadata into high-fidelity signals for technical debt, knowledge silos, and refactoring ROI—empowering both humans and AI agents to make data-driven architecture decisions.
- 🤖 Agentic Hub - Native MCP server with shape-aware "Reasoning" labels for autonomous auditing.
- 🔍 Tactical CLI - Rapid file/folder ranking by activity, complexity, and ownership.
- 🧮 Deep Metrics - High-fidelity signals for churn, Ginni coefficients, and bus factor risk.
- 🕓 Trend Tracking - Time-anchored analysis and delta tracking across Git references.
- 📊 Polyglot Exports - Professional CSV/JSON/Parquet/Markdown reporting.
- Go 1.26+ for building from source
- Git 2.2+ for repository analysis
go install github.com/huangsam/hotspot@latestVisit the latest release and download the tar archive for your system (supports Windows, macOS, and Linux), then extract the binary to your $PATH.
Hotspot is designed for both human-driven tactical analysis and AI-driven strategic auditing.
Hotspot includes a Self-Documenting Agentic Hub via the Model Context Protocol (MCP). This allows AI agents to autonomously explore your repository.
# Start the MCP server (stdio)
hotspot mcpFor immediate terminal-based checks and CI/CD integration.
# Initialize hotspot with sensible defaults
hotspot init
# Analyze files for tactical risk
hotspot files
# Analyze folders for strategic subsystems
hotspot folders- USERGUIDE.md: Essential guide for analysis features, scoring modes, and core workflows.
- PLAYBOOK.md: Actionable guidance on using this data to foster a healthy engineering culture.
Hotspot is optimized for speed, even on massive repositories, by caching Git analysis results and using concurrent workers.
Comprehensive performance benchmarks using this script. This shows cold vs warm timings:
| Repository | Files (Cold/Warm) | Compare Files (Cold/Warm) | Timeseries (Cold/Warm) |
|---|---|---|---|
| csv-parser | 0.075s / 0.026s | 0.144s / 0.051s | 0.168s / 0.074s |
| fd | 0.045s / 0.024s | 0.083s / 0.048s | 0.132s / 0.069s |
| git | 0.546s / 0.041s | 1.389s / 0.175s | 2.039s / 0.243s |
| kubernetes | 3.018s / 0.146s | 7.330s / 1.456s | 11.508s / 0.925s |
The data shows that Hotspot caches Git analysis results to speed up repeated runs.