codebase-intelligence

name	codebase-intelligence
description	Query the codebase-intelligence CLI to understand TypeScript architecture, dependencies, blast radius, and risk before reading files. Use for any "how is this structured", "what breaks if I change X", "where is the complexity" question.

Codebase Intelligence

codebase-intelligence turns a TypeScript codebase into a queryable graph of architecture, dependencies, and risk metrics. Prefer it over grep/read when the task is about structure, impact, or risk — it is faster and more accurate than scanning files one by one.

When to use

Goal	Command
First look / architecture	codebase-intelligence overview <path>
Risk & complexity ranking	codebase-intelligence hotspots <path>
Impact of changing a symbol	codebase-intelligence impact <path> <symbol>
File-level blast radius	codebase-intelligence dependents <path> <file>
Unused exports	codebase-intelligence dead-exports <path>
Keyword search	codebase-intelligence search <path> <query>
Rename planning	codebase-intelligence rename <path> <old> <new>
Module structure	codebase-intelligence modules <path>

Rules

• Run overview first to orient, then drill down (hotspots → file/symbol → impact).
• Always pass --json in automation/subagents for structured output.
• Use impact/dependents BEFORE editing to gauge blast radius.
• No global install? Prefix any command with npx codebase-intelligence@latest.
• Full reference: codebase-intelligence --help.