Editors and agents

npx -y @sylphx/repomap setup configures every client below that it detects. Each client runs the same command:

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

Client	Config written
Claude Code	claude mcp add --scope user repomap -- npx -y @sylphx/repomap mcp (or ~/.claude.json)
Codex	~/.codex/config.toml → [mcp_servers.repomap]
Cursor	~/.cursor/mcp.json → mcpServers.repomap
VS Code (+ Insiders)	<user dir>/mcp.json → servers.repomap
Claude Desktop	claude_desktop_config.json → mcpServers.repomap
Windsurf	~/.codeium/windsurf/mcp_config.json
Gemini CLI	~/.gemini/settings.json

On Windows the command is cmd /c npx ….

Claude Code hook (optional)

setup --claude-hooks also installs a PreToolUse hook. Whenever Claude Code runs Grep or Glob, the hook adds where the symbol is defined and who calls it. See Claude Code hook.

Which repository is indexed

In order of precedence:

1. the root argument of a tool call
2. REPOMAP_ROOT
3. repomap mcp --root <dir>
4. the client's workspace root (MCP roots)
5. the server's working directory (Claude Code, Codex and Cursor start it in your project)

Claude Desktop has no project directory, so ask it to pass root, for example: "map /Users/me/code/app".

Options

• REPOMAP_CACHE_DIR: where per-file parse caches live (default: your OS cache dir, …/repomap/<repo>-<hash>)
• REPOMAP_LEGACY_TOOLS=1: also list the old architecture_* and codebase_search names in tools/list
• .repomapignore: extra ignore patterns in .gitignore syntax