ts-codemap

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/.