Skip to content
Back to search

cartographer-marketplace

MarketplaceWorks with Claude CodeGitHub

Claude Code plugin that maps and documents codebases of any size using parallel AI subagents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kingbootoshi-cartographer/badge.svg)](/listings/kingbootoshi-cartographer)

HTML

<a href="/listings/kingbootoshi-cartographer"><img src="/api/listings/kingbootoshi-cartographer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The section below documents the legacy Claude Code plugin workflow that produces `docs/CODEBASE_MAP.md` by orchestrating subagents. It is separate from the Cartographer v2 graph CLI above. For new agent/orchestrator workflows, prefer the v2 `brief`, `audit`, and `notes` commands.

**Step 1:** Add the marketplace to Claude Code:

/plugin marketplace add kingbootoshi/cartographer

**Step 2:** Install the plugin:

/plugin install cartographer

**Step 3:** Restart Claude Code (may be required for the skill to load)

**Step 4:** Use it:

/cartographer

Or just say "map this codebase" and it will trigger automatically.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "cartographer-marketplace",
  3. "owner": {
  4. "name": "Bootoshi",
  5. "url": "https://github.com/kingbootoshi"
  6. },
  7. "metadata": {
  8. "description": "Maps and documents codebases of any size using parallel AI subagents",
  9. "version": "1.0.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "cartographer",
  14. "source": "./plugins/cartographer",
  15. "description": "Maps and documents codebases of any size by orchestrating parallel subagents. Creates docs/CODEBASE_MAP.md with architecture, file purposes, dependencies, and navigation guides.",
  16. "version": "1.4.0",
  17. "category": "developer tools",
  18. "keywords": ["codebase", "architecture", "documentation", "mapping", "onboarding", "subagents"]
  19. }
  20. ]
  21. }
README.md · README · 125 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Cartographer
  2. <img width="640" height="360" alt="claudecartographer" src="https://github.com/user-attachments/assets/542818c6-fc2b-41a6-915d-cf196447f346" />
  3. A standalone Cartographer CLI plus Claude Code plugin for mapping and navigating codebases.
  4. 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.
  5. ## CLI
  6. Install dependencies:
  7. ```bash
  8. bun install
  9. ```
  10. Run the CLI:
  11. ```bash
  12. bun run cartographer -- --help
  13. bun run cartographer:mcp
  14. bun run cartographer:index -- --root . --out .cartographer
  15. bun run cartographer:verify -- --out .cartographer --root . --fresh
  16. bun run cartographer:view -- --out .cartographer
  17. bun run cartographer:brief -- --out .cartographer --path src/index.ts --mode implementation --json
  18. bun run cartographer:audit -- removal --out .cartographer --target supabase --write .cartographer/audits/supabase-removal.json
  19. bun run cartographer:notes -- audit --out .cartographer --json
  20. bun run cartographer:export -- graph --from .cartographer --format debug-json --out .cartographer/exports/graph.debug.json
  21. ```
  22. Run the deterministic Cartographer eval smoke profile:
  23. ```bash
  24. bun run eval:cartographer:smoke
  25. bun run eval:cartographer:codex
  26. bun run eval:cartographer:codex:live
  27. ```
  28. 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`.
  29. Core commands:
  30. - `mcp` - run a thin newline-delimited MCP stdio wrapper over Cartographer graph operations.
  31. - `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.
  32. - `verify` - check graph artifact compatibility and, with `--fresh`, fail when persisted artifacts drift from the live repo.
  33. - `view` - summarize an existing graph.
  34. - `brief` - emit bounded agent-facing context around a path, package, symbol, env var, DB/IaC object, audit ledger, or changed files.
  35. - `audit removal` / `audit verify` - create and verify task-specific removal ledgers.
  36. - `notes ingest` / `notes audit` / `notes accept` / `notes retire` - manage evidence-backed semantic notes.
  37. - `export graph` - explicitly export full debug JSON or JSONL graph data.
  38. - `diff` - compare two graph artifact directories.
  39. - `slice`, `impact`, `context`, `preflight` - compatibility/debug graph surfaces. Broad selectors require `--allow-broad` or `--debug-graph`.
  40. - `adoption` - score graph-first behavior from runtime traces.
  41. - `annotate` / `annotations` - legacy OpenRouter annotation workflow, superseded for daily use by `notes`.
  42. The MCP wrapper exposes `cartographer_index`, `cartographer_view`, `cartographer_brief`, `cartographer_context`, `cartographer_preflight`, `cartographer_verify`, `cartographer_audit_removal`, `cartographer_audit_verify`, `cartographer_notes_audit`, and `cartographer_diff` as tools. It wraps the same library functions as the CLI; it does not become a long-lived graph brain or agent manager.
  43. ## Installation
  44. The section below documents the legacy Claude Code plugin workflow that produces `docs/CODEBASE_MAP.md` by orchestrating subagents. It is separate from the Cartographer v2 graph CLI above. For new agent/orchestrator workflows, prefer the v2 `brief`, `audit`, and `notes` commands.
  45. **Step 1:** Add the marketplace to Claude Code:
  46. ```
  47. /plugin marketplace add kingbootoshi/cartographer
  48. ```
  49. **Step 2:** Install the plugin:
  50. ```
  51. /plugin install cartographer
  52. ```
  53. **Step 3:** Restart Claude Code (may be required for the skill to load)
  54. **Step 4:** Use it:
  55. ```
  56. /cartographer
  57. ```
  58. Or just say "map this codebase" and it will trigger automatically.
  59. ## What it Does
  60. Cartographer orchestrates multiple Sonnet subagents to analyze your entire codebase in parallel, then synthesizes their findings into:
  61. - `docs/CODEBASE_MAP.md` - Detailed architecture map with file purposes, dependencies, data flows, and navigation guides
  62. - Updates `CLAUDE.md` with a summary pointing to the map
  63. ## How it Works
  64. 1. Runs a scanner script to get file tree with token counts (respects .gitignore)
  65. 2. Plans how to split work across subagents based on token budgets
  66. 3. Spawns Sonnet subagents in parallel - each analyzes a portion of the codebase
  67. 4. Synthesizes all subagent reports into comprehensive documentation
  68. ## Update Mode
  69. If `docs/CODEBASE_MAP.md` already exists, Cartographer will:
  70. 1. Check git history for changes since last mapping
  71. 2. Only re-analyze changed modules
  72. 3. Merge updates with existing documentation
  73. Just run `/cartographer` again to update.
  74. ## Token Usage
  75. ⚠️ **NOTE:** This skill spawns Sonnet subagents for accurate, reliable analysis. Depending on codebase size, this can use significant tokens. Be mindful of your usage.
  76. You can ask Claude to use Haiku subagents instead for a cheaper run, but accuracy may suffer on complex codebases.
  77. ## Requirements
  78. - tiktoken (for token counting): `pip install tiktoken` or `uv pip install tiktoken`
  79. ## Full Documentation
  80. See [plugins/cartographer/README.md](plugins/cartographer/README.md) for detailed documentation.
  81. ## License
  82. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.