# repomap

> repomap is an open-source MCP server for developer tools. Local code graph for agents with search, call tracing and change impact analysis. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://sylphxai.github.io/repomap/
- **Repository:** https://github.com/sylphxai/repomap
- **MCP Registry name:** io.github.SylphxAI/repomap
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

repomap indexes a repository with a parallel Rust indexer and keeps an in-memory graph that refreshes as you edit. It then offers five views: a map of modules, central files by PageRank and entry points; hybrid search combining symbol names, BM25 and a local code embedding model; a context call with a symbol's callers, callees and tests; a trace for the shortest call path between two symbols; and an impact call that lists callers by depth, importing files, tests to run and a risk level for a symbol or your current git diff.

Results cite file:line. The project reports finding every fix file in the top ten for 83.0% of SWE-bench Verified issues against 71.0% for semble, and openly notes semble wins slightly on its own public search set. Indexing excalidraw (687 files) takes under half a second.

Everything is local, needs no API key and is MIT licensed. A setup command writes config for Claude Code, Codex, Cursor, VS Code, Claude Desktop, Windsurf and Gemini CLI, and a graph UI is available.

## Features

- **Repository map:** Shows modules, central files and entry points.
- **Hybrid search:** Combines names, BM25 and local embeddings.
- **Call tracing:** Finds the shortest call path between two symbols.
- **Impact analysis:** Lists callers, tests to run and risk for a change.
- **Graph UI:** Browse the graph in an interactive interface.

## Good for

- Map an unfamiliar repository before editing
- Find files related to a bug report
- See what breaks if a function changes
- Pick tests to run for a diff

## Install

### Claude Code (Terminal)

```sh
claude mcp add repomap -- npx -y @sylphx/repomap
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `map`: Shows modules, central files, key symbols and entry points.
- `search`: Searches symbols and code by name or plain words.
- `context`: Returns a symbol's code, callers, callees and tests.
- `trace`: Finds the shortest call path between two symbols.
- `impact`: Shows the blast radius of a change or git diff.

## FAQ

### Does it need an API key?

No. It runs locally and nothing leaves your machine.

### How do I install it?

Run npx -y @sylphx/repomap setup to configure supported clients.

### What licence is it?

MIT.

### How fast is indexing?

The site reports excalidraw's 687 files indexed in under half a second.

### Is repomap free?

Yes. repomap is open source, so you can use and self-host it for free.

### How do I add repomap to Claude Code?

Run this command in your terminal: claude mcp add repomap -- npx -y @sylphx/repomap

### What are the best alternatives to repomap?

The closest alternatives to repomap are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/repomap
