Codebase Radar

Scan codebase for dependency graph, tech debt hotspots, and module health scores

Full-spectrum static analysis for any codebase: dependency graphs, module health scoring, tech debt detection, dead code, and visualization in Mermaid/D2.

Workflow

1. Project scan — Tree view, line counts, language distribution, file size outliers.
2. Dependency graph — Resolve imports/requires across modules; detect circular dependencies; list external deps with versions.
3. Cohesion & coupling — Score each module: how focused its internals are (cohesion) and how tightly bound to others (coupling).
4. Tech debt signals — Scan for TODO/FIXME/HACK density, outdated dependency alerts, low comment-to-code ratio.
5. Dead code detection — Find unreferenced functions, classes, variables; flag large commented-out blocks.
6. Health scorecard — 5-dimension score per module: Cohesion, Coupling, Maintainability, Coverage estimate, Tech debt.
7. Visualization — Generate dependency diagram in Mermaid (graph TD) or D2 format.
8. Report — Produce project health summary with ranked refactoring priorities.

Sample Prompts

• codebase-radar scan --path ./my-project --format json > report.json
• codebase-radar scan --path ./my-project --visual mermaid --output deps.md
• codebase-radar health --path ./my-project --score-only --json
• codebase-radar deadcode --path ./src --exclude tests/

Safety

• Read-only scanner; never modifies source files.
• Language-agnostic for import detection; language-specific analyzers are opt-in.
• Large repos may require --max-files limit to avoid memory issues.