repomap

Quickstart ​

1. Connect your agent ​

bash
npx -y @sylphx/repomap setup

setup finds the MCP clients you have (Claude Code, Codex, Cursor, VS Code, Claude Desktop, Windsurf and Gemini CLI), adds repomap to each one, and prints what it changed. It is safe to run again. Use --dry-run to preview, --client cursor,codex to pick clients, and --remove to undo.

Cursor and VS Code, one click ​

Add to Cursor · Install in VS Code

Requires Node 18+. Confirm the install in your editor, open your project, and enable the server. Both links run npx -y @sylphx/repomap mcp locally; no API key is needed.

For VS Code from a terminal:

bash
code --add-mcp '{"name":"repomap","command":"npx","args":["-y","@sylphx/repomap","mcp"]}'

Or add the server to .cursor/mcp.json:

json
{
  "mcpServers": {
    "repomap": {
      "command": "npx",
      "args": [
        "-y",
        "@sylphx/repomap",
        "mcp"
      ]
    }
  }
}

For .vscode/mcp.json, use the VS Code servers format:

json
{
  "servers": {
    "repomap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sylphx/repomap",
        "mcp"
      ]
    }
  }
}

Restart the client, then ask:

Use repomap to map this repo, then show me what would break if I changed SessionStore.refresh.

2. See the map ​

bash
cd your-repo
npx -y @sylphx/repomap serve

Your browser opens the graph UI. To publish a snapshot, run npx -y @sylphx/repomap export. It writes repomap.html, which you can open anywhere.

3. Use it from the terminal ​

bash
npx -y @sylphx/repomap map                       # overview
npx -y @sylphx/repomap search "retry backoff"    # hybrid search
npx -y @sylphx/repomap context Client.send       # 360° view
npx -y @sylphx/repomap trace main handleRequest  # call path
npx -y @sylphx/repomap impact --changed          # blast radius of your diff

For a global install, run npm i -g @sylphx/repomap, then use repomap ….

Supported platforms ​

macOS (Apple silicon, Intel), Linux glibc (x64, arm64) and Windows x64. Node 18+ is only used to launch the native binary. You can also download a binary from GitHub releases or build one with cargo install --git https://github.com/SylphxAI/repomap sylphx-repomap.