mcpField
M
map

map

github.com/htlin222Development7837 installsUpdated 3w ago
Repository

About map

map is a codebase symbol-map generator for developers exploring or refactoring a project. It detects supported languages and records exported symbols with precise file and line locations.

Key features

  1. 01Detect TypeScript, JavaScript, Python, Rust, and Go
  2. 02Extract exported symbols
  3. 03Record file and line locations
  4. 04Generate a Markdown symbol map

Use cases

  1. 01Explore an unfamiliar codebase
  2. 02Locate symbols before refactoring

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/htlin222/dotfiles --skill map

After installing, type/mapin Claude Code to confirm it loaded.

Bundled filesscripts/symbol_map.py

Details

From the project README

Codebase Symbol Map Generator

Generate a semantic symbol map showing where all exports, classes, functions, and interfaces are defined. This eliminates guessing with rg by providing precise file:line locations.

When to Use

  • Starting work on an unfamiliar codebase
  • Before large-scale refactoring
  • When needing to understand code structure
  • To avoid rg text-matching confusion (same name in comments/strings)

Execution

Run the generator script:

python3 ~/.claude/skills/map/scripts/symbol_map.py

The script will:

  1. Detect project language (TypeScript/JavaScript/Python/Rust/Go)
  2. Extract all exported symbols with their locations
  3. Generate a markdown map at ~/.claude/codebase-maps/{project}_symbols.md

Output Format

## Symbol Index by Type

### Classes

| Symbol         | Location                  |
| -------------- | ------------------------- |
| `AuthProvider` | `src/auth/provider.ts:15` |

### Functions

| Symbol       | Location               |
| ------------ | ---------------------- |
| `formatDate` | `src/utils/date.ts:42` |

Usage After Generation

After running /map, use the symbol locations directly:

  • "Read src/auth/provider.ts:15 to check AuthProvider"
  • "The formatDate function at src/utils/date.ts:42 needs modification"

No more grepping and guessing.

Comments

Markdown supported