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.
Visual Risk Intelligence: Hotspot transforms Git metadata into interactive heatmaps that instantly reveal your codebase's risk distribution. Files are color-coded by risk level (green=low, red=high) and sized by complexity, making technical debt visible at a glance.
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.
- 🗺️ Visual Risk Radar - SVG heatmaps that make technical debt instantly visible.
- 🤖 Agentic Intelligence - MCP server with shape-aware "Reasoning" for analysis.
- 🚢 Fleet-Scale Discovery - Recursive analysis and risk mapping across projects.
- 💼 Professional Analytics - High-fidelity metrics with standard data exports.
- 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
# Generate heatmap
hotspot files --mode hot --output heatmap --output-file heatmap.svg
# Analyze files in tabular format
hotspot files
# Analyze folders in tabular format
hotspot folders
# Discover and assess multiple repositories (Fleet Analysis)
hotspot batch --auto /path/to/projects- 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.