Free Tools

Open-source tools I've built and use myself.

CLI Tool · Rust · MIT

Hotspots

GitHub

Every codebase has a small cluster of files that cause most of the pain. Hotspots finds them by combining structural complexity metrics (cyclomatic complexity, nesting depth, fan-out) with real git activity — so you see which functions are both hard to change and actively being changed.

Install

curl -fsSL https://raw.githubusercontent.com/Stephen-Collins-tech/hotspots/main/install.sh | sh

Quick start

# Snapshot your current repo
hotspots analyze . --mode snapshot --format text
# Full JSON with antipattern labels
hotspots analyze . --mode snapshot --format json --explain-patterns
# CI policy check (exits 1 on violations)
hotspots analyze . --mode delta --policy
  • ✓ Activity-weighted risk scores — complexity × git churn, not just raw metrics
  • ✓ Antipattern labels: god_function, cyclic_hub, churn_magnet, and more
  • ✓ Delta mode with CI policy checks — fail PRs that introduce new critical-band functions
  • ✓ HTML and JSON output formats; works on any language
  • ✓ Written in Rust — fast, no runtime dependencies
View on GitHub Docs Live OSS Analyses → Read the intro post

More tools coming

Have a tool you wish existed? If it's broadly useful I'll build a lean version and drop it here.

Suggest a tool