What problem does it solve?
Build and maintain a persistent structural index of a TypeScript/JavaScript codebase under .codemap/ (graph.json + MAP.md), so other skills explore the map instead of grep + read loops. It uses ts-morph for high-fidelity TS/JS parsing (tsconfig path aliases, re-export flattening, JSX). Use when the user asks to build, refresh, or update the codemap in a TS/JS repository, when starting work in an unfamiliar TS/JS repo, or before any exploration phase that would otherwise scan source files. For Java/Go/Python/Rust repos, use the language-agnostic codemap skill instead.
Core Features & Use Cases
- Persistent, file-based map of a TS/JS codebase under .codemap/ with graph.json and MAP.md that other skills can read to navigate the codebase.
- TS/JS-specific parsing via ts-morph (handles tsconfig path aliases, re-export flattening, and JSX) and symbol graph generation.
- Incremental builds with per-file SHA256 caching and a deterministic graph format; includes Next.js route detection and re-exports resolution for stable IDs.
Quick Start
Run the codemap build against your repository to generate the mapping under .codemap/.