// readme

Cartog

Map your codebase. Navigate by graph, not grep.

Semantic search that returns named symbols, not text chunks, ranked, reranked, and budget-aware.

~280 tokens per query vs ~1,700 for grep+read · 97% recall · 8 µs–20 ms structural-query latency · 18 languages + 4 frameworks.

Cartog pre-computes a code graph (symbols, and the calls, imports, and inheritance between them) so you can query structure instantly instead of grepping for text. Ask “who calls this?”, “what breaks if I change it?”, or “find the auth logic” and get a ranked, structured answer: an exact function with its signature and span, not a file-and-line guess you have to open and read.

Use it from the CLI for day-to-day navigation, or as an MCP server so AI agents query the graph instead of flooding their context with raw file dumps, at a fraction of the token cost. One static binary, one SQLite file. No Python, no pip, no Docker, no cloud: 100% local by default.

Documentation site

Contents