Codemapper

Code analysis tool (cm ) for exploring structure, symbols, dependencies, and call graphs.

All commands support --format ai for concise, AI-friendly output.

Code Statistics

cm stats . --format ai # Current directory cm stats ./src --format ai # Specific directory

Code Map

cm map . --level 2 --format ai # Basic overview cm map . --level 3 --format ai # Detailed structure cm map . --level 2 --exports-only --format ai # Public API only cm map ./src --level 2 --format ai # Specific directory

Detail levels:

• Level 1: Files and directories only

• Level 2: Files with exported symbols

• Level 3: Files with all symbols and details

Query Symbols

cm query authenticate . --format ai # Fuzzy search cm query User . --exact --format ai # Exact match cm query validate . --show-body --format ai # Show implementation cm query process . --exports-only --format ai # Public only

Call Graph Analysis

Find callers of a function

cm callers processData . --format ai cm callers UserService.get . --format ai

Find callees (what a function calls)

cm callees processData . --format ai cm callees UserService . --format ai

Trace call path

cm call-path functionToFind . --format ai cm call-path functionToFind --reverse --format ai

Dependency Analysis

cm deps . --format ai # List all dependencies cm deps . --circular --format ai # Detect circular deps cm deps . --unused --format ai # Find unused deps cm deps . --unused-symbols --format ai # Find unused symbols

Finding Tests

cm tests functionName . --format ai # Find tests for function cm untested . --format ai # Find untested code

Common Workflows

Code Exploration

cm map . --level 2 --format ai # Get overview cm query User . --format ai # Find symbols cm deps . --format ai # Understand deps

Refactoring Preparation

cm tests functionToRefactor . --format ai # Check test coverage cm callers functionToRefactor . --format ai # Find callers to update cm callees functionToRefactor . --format ai # Find callees cm deps . --circular --format ai # Check for cycles

Tips

• Use --format ai for concise output

• Use --level 2 for overview, --level 3 for details

• Use --exports-only to see public API

• Use --show-body to see implementation details

• Use --exact for precise matching