Agent-Skills.md

Agent Skills: Codemapper

Maps codebase structure, queries symbols, traces call paths, and analyzes dependencies. Use when exploring unfamiliar code, finding function callers/callees, detecting circular imports, or generating project overviews.

UncategorizedID: knoopx/pi/codemapper

Repository

knoopx/pi
knoopx
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/knoopx/pi/tree/HEAD/agent/skills/codemapper

Skill Files

Browse the full folder contents for codemapper.

Download Skill

Loading file tree…

agent/skills/codemapper/SKILL.md

Skill Metadata

Name
codemapper
Description
Maps codebase structure, queries symbols, traces call paths, and analyzes dependencies. Use when exploring unfamiliar code, finding function callers/callees, detecting circular imports, or generating project overviews.

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