What problem does it solve?
Build and maintain a persistent structural index of a multi-language codebase under .codemap/ (graph.json + MAP.md) so teams can explore symbols, imports, and relationships without grep-and-read loops. It supports Java, Go, Python, and Rust, and is designed to be used after large refactors or at the start of exploration in unfamiliar repos; for TypeScript/JavaScript, the sibling ts-codemap offers higher fidelity.
Core Features & Use Cases
- Persistent file-based map: walks the repository with tree-sitter, writes graph.json and MAP.md under .codemap/ for downstream skills to query.
- Polyglot support and incremental updates: indexes Java, Go, Python, and Rust with per-file SHA256 caching for fast rebuilds.
- Use Case: after a major codebase refactor, codemap surfaces module boundaries, symbol exports, and import/calls edges to guide exploration and planning.
Quick Start
Run codemap build on a repository to generate the graph and MAP.md under .codemap.