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
overviewfirst to orient, then drill down (hotspots → file/symbol → impact). - Always pass
--jsonin automation/subagents for structured output. - Use
impact/dependentsBEFORE editing to gauge blast radius. - No global install? Prefix any command with
npx codebase-intelligence@latest. - Full reference:
codebase-intelligence --help.