Install

Cartographer is distributed as a Cursor plugin and a local CLI built from this repository (or GitHub Releases). It is not published as an npm registry package.

Cursor plugin: see the public listing at https://cursor.directory/u/theworker02 for screenshots and install details. You can also install from this repository locally (build dist/ first).

Local CLI from source

git clone https://github.com/theworker02/cartographer.git
cd cartographer
npm install
npm run build
npm link   # optional — puts cartographer on your PATH

Then, in any project:

cartographer index
cartographer brief

Cursor plugin

Point Cursor at this repo as a local plugin (manifest: .cursor-plugin/plugin.json). Build dist/ first so MCP and CLI entrypoints resolve.

Commands under commands/
Skill skills/cartographer
Agent agents/cartographer-navigator
Rules rules/cartographer.mdc
MCP via mcp.json → dist/mcp/index.js

Requirements

Node.js 20+ (22/24 recommended; uses built-in node:sqlite)
No API keys. Works offline.