Skip to content

Cartographer v0.2.0 — Living Atlas Briefing

Latest
Latest

Choose a tag to compare

View all tags
@theworker02 theworker02 released this 13 Aug 23:04
· 2 commits to main since this release
v0.2.0
6b31aba

Cartographer v0.2.0 — Living Atlas Briefing

Cartographer is a local-first navigation system for software architecture. This release centers the Living Atlas Briefing: orientation-first mapping so humans and agents know where they are in the code before they change anything.

Tagline: Know where you are in the code.

Highlights

  • Living Atlas Briefing — Mini Atlas tree, YOU ARE HERE breadcrumb with territory confidence, top corridors in plain language, hubs & bridges, fog-of-war frontiers, and a start-here journey suggestion. Designed so you can orient in a foreign repo in about fifteen seconds.
  • Shared briefing surface across index, brief, whereami, and tour — one map language everywhere.
  • Corridor-aware routes, hub/bridge detection, landmark drift checks, concept search, and doctor integrity checks.

Cursor plugin status

  • Ships as a Cursor plugin (slash commands, skill, agent, rules, MCP) plus a local CLI.
  • Marketplace listing is pending Cursor approval. Local plugin install from this repository works today.
  • Not published to the Cursor Marketplace yet — clone this repo, build, and load as a local plugin.

CLI & MCP

  • Full local CLI: index, brief, whereami, goto, route, explain-route, upstream / downstream, territories, hubs, corridors, landmarks, journeys, tour, unexplored, search, history, status, doctor.
  • MCP server mirrors the Atlas facade (cartographer_brief, cartographer_whereami, cartographer_route, and related tools) for agent workflows.
  • Persistent SQLite Atlas under .cartographer/ — local-first, no required API keys.

Docs & Pages

Privacy

  • No telemetry, analytics, or phone-home for core navigation.
  • Atlas data stays on your machine; Git history is read locally when enabled.
  • Treat .cartographer/ like any other project cache (paths and symbol names).

Install from source

This release is not an npm registry package. There is no npm install -g cartographer.

\\�ash
git clone https://github.com/theworker02/cartographer.git
cd cartographer
npm install
npm run build
npm link # optional
\\

Requires Node.js 20+ (22/24 recommended). Then in your project:

\\�ash
cartographer index
cartographer brief
\\

Cursor: build dist/, then install this repository as a local plugin (Marketplace approval pending).

What's in the box

Piece Description
Living Atlas Briefing Flagship orientation UX
Cursor plugin Commands, skill, agent, rules, hooks, MCP
Local CLI cartographer binary from source / Releases
MCP server Agent tools over the same Atlas
Language adapters TypeScript/JavaScript, Python, Go, Rust
GitHub Pages Brand site + install / architecture / privacy
Funding Sponsors + thanks.dev

Funding

Support independent development:

See CHANGELOG.md for the full change list.

Assets 2
Loading