codemap-creator

Code Map Creator

Generate or update a hierarchical code map using Claude Code's built-in LSP tools. Maps functions, classes, variables, and imports in a nested tree structure.

Modes

Create Mode (default)

Generate a new codemap from scratch:

/codemap-creator src/
/codemap-creator . --ignore "node_modules,dist"

Update Mode

Update an existing codemap with only changed files:

/codemap-creator --update .claude/maps/code-map-src-a3f9e.json --diff
/codemap-creator --update .claude/maps/code-map-src-a3f9e.json --mr 123
/codemap-creator --update .claude/maps/code-map-src-a3f9e.json --pr 456

Arguments

Create Mode

• Root directory (required): Starting point for the tree

  • /codemap-creator src/ → maps from src/ as root
  • /codemap-creator backend/services → maps from services/ as root
  • /codemap-creator . → maps entire project as root

• Ignore patterns (optional): Skip files/directories

  • /codemap-creator src/ --ignore "*.test.ts,node_modules"

Update Mode

• --update (required): Path to existing codemap to update
• --diff (optional): Use git diff to find changed files (uncommitted + staged)
• --mr (optional): Use GitLab MR to find changed files (via glab)
• --pr (optional): Use GitHub PR to find changed files (via gh)

If no diff source specified with --update, defaults to --diff.

Hierarchical Output

The codemap shows a nested tree structure from your chosen root:

root_dir/
├── subdir1/
│   ├── file1.ts
│   │   └── symbols: [class UserService, function getUser...]
│   └── nested/
│       └── file2.ts
│           └── symbols: [interface Config...]
├── subdir2/
│   └── file3.ts
│       └── symbols: [function helper...]
└── index.ts
    └── symbols: [export *, function main...]

Instructions

Step 1: Parse Input and Detect Mode

Parse $ARGUMENTS to determine mode:

Update Mode (if --update present):

1. Extract codemap path after --update
2. Detect diff source:
   • --diff → use git diff --name-only + git diff --staged --name-only
   • --mr <id> → use glab mr diff <id> --name-only
   • --pr <id> → use gh pr diff <id> --name-only
   • Default to --diff if no source specified
3. Get list of changed files