Cartographer

Cartographer

A standalone Cartographer CLI plus Claude Code plugin for mapping and navigating codebases.

Cartographer v2 adds a graph CLI for intelligent coding agents: index a repo into a local SQLite graph, compile bounded briefs, run removal/completeness audits, manage evidence-backed notes, and score whether agents used graph context before editing.

CLI

Install dependencies:

Run the CLI:

Run the deterministic Cartographer eval smoke profile:

The smoke, recorded Codex-trace, and explicit live Codex profiles index this repo and use /Users/saint/dev/agent-runtime-kernel as a read-only external target. They write graph artifacts under /tmp/cartographer-code-graph-evals and append-only JSON reports under docs/reports.

Core commands:

- mcp - run a thin newline-delimited MCP stdio wrapper over Cartographer graph operations.
- index - build .cartographer/manifest.json, .cartographer/graph.sqlite, JSON schemas, and CODEBASE_MAP.md; unchanged repos reuse prior artifacts through the SQLite file-hash cache unless --force or --no-incremental is passed.
- verify - check graph artifact compatibility and, with --fresh, fail when persisted artifacts drift from the live repo.
- view - summarize an existing graph.
- brief - emit bounded agent-facing context around a path, package, symbol, env var, DB/IaC object, audit ledger, or changed files.
- audit removal / audit verify - create and verify task-specific removal ledgers.
- notes ingest / notes audit / notes accept / notes retire - manage evidence-backed semantic notes.
- export graph - explicitly export full debug JSON or JSONL graph data.
- diff - compare two graph artifact directories.
- slice, impact, context, preflight - compatibility/debug graph surfaces. Broad selectors require --allow-broad or --debug-graph.
-…