# Graph Indexer

> Graph Indexer is a live code graph and search engine for AI coding agents, served locally over MCP: exact references, call graphs, change impact and edit checks, with no model, no network and no native build.

Graph Indexer 3.0.0 (released 2026-09-23) parses a repository with tree-sitter, binds every use to the definition it points at, and answers agent questions in 400-1,500 tokens a reply. The index is re-synced before every answer. Install with `npx graph-indexer init`.

Website: https://graph-indexer.vercel.app/ (Spanish: https://graph-indexer.vercel.app/es/). Every page has a Markdown twin at the same URL with `.md` (the home page: https://graph-indexer.vercel.app/index.md). The landing is visual; the pages below hold the details.

## Key facts

- 8 read-only MCP tools: find_references, change_impact, check_changes, call_graph, search_code, read_code, search_text, outline. Also a CLI and hooks.
- 16 bundled tree-sitter grammars (15 languages plus TSX, WebAssembly). Deepest support: TypeScript, JavaScript, Python, Go, Java, C# and Rust.
- Requires Node.js 22.5+ (built-in node:sqlite). Zero dependencies. MIT license.
- Local: Graph Indexer makes no network calls of its own, no telemetry, no model. (Your agent still sends what it reads to its model provider.) The index lives in a git-ignored .graph-indexer/ folder.
- 99.7% of the references it returns are real (TypeScript compiler, 400 nestjs symbols); grep for the name: 12.8%. The agent's context holds signal, not noise: fewer tokens and more accurate answers.
- 12/12 exact answers to 12 code questions on nestjs in real Claude Code sessions, against 9/12 without it.
- Reference precision against each language's own type checker, grep vs Graph Indexer: nestjs 99.7% vs 12.8%, Twenty (2.3M lines) 99.9% vs 0.9%, Go (gin, caddy, nats-server) 99.2-100% vs 8.5-23.8%, Java (petclinic, jsoup, commons-collections) 95.5-99.4% vs 1.5-60.9%.
- About 16% cheaper code questions and 14% cheaper refactors than with no index, in real Claude Code sessions (24 code questions on nestjs and Twenty); about half the lookup tokens. Against grep alone, 25 code questions were 33% cheaper and took 32% less time.
- With a smaller model, 7/7 exact answers against 5/7 with grep only, at 74% lower cost and 68% less time. On Go (caddy) real sessions: 14/14 against 13/14 at 13% lower cost.
- Fast: more than 45,000 lines indexed per second (the 2.3M-line Twenty monorepo in 51 s); warm graph-tool calls answer in under 4 ms; an unchanged repository re-syncs in 0.2 s (nestjs).
- Available as a Claude Code plugin: `/plugin marketplace add MaquinaTech/graph-indexer`, then `/plugin install graph-indexer@graph-indexer`. It bundles the MCP server, hooks and a structural helper sub-agent.
- Works with 10 agents: Claude Code, Cursor, VS Code Copilot, Codex, Gemini CLI, OpenCode, Kilo Code, Junie, Zed and Devin.
- Honest limits: not a type checker; does not make fixing real issues cheaper; samples in the agent benchmarks are small. Caveats are published with the benchmarks.

## Docs

- [Install Graph Indexer](https://graph-indexer.vercel.app/install.md): Install Graph Indexer with npx graph-indexer init: it needs Node.js 22.5+, wires the MCP server into your AI coding agents and builds a local code index.
- [Graph Indexer Claude Code Plugin](https://graph-indexer.vercel.app/claude-code-plugin.md): Install the Graph Indexer plugin for Claude Code in two commands. It bundles the MCP server, three hooks and the code-structure sub-agent, all local.
- [The 8 MCP tools of Graph Indexer](https://graph-indexer.vercel.app/tools.md): Reference for the 8 read-only MCP tools of Graph Indexer: find_references, change_impact, call_graph, search_code and more, with parameters and sample output.
- [How Graph Indexer works](https://graph-indexer.vercel.app/how-it-works.md): How Graph Indexer builds a code graph: tree-sitter WASM parsing, reference binding, a local SQLite index, re-sync before each answer, no embeddings.
- [Languages Graph Indexer supports](https://graph-indexer.vercel.app/languages.md): Graph Indexer parses 16 bundled tree-sitter grammars (TypeScript, Python, Go, Java, C#, Rust, Kotlin and more) with deepest reference binding in 7 of them.
- [Graph Indexer FAQ](https://graph-indexer.vercel.app/faq.md): Answers about Graph Indexer: what it is, how it differs from grep, privacy, cost, speed, languages, monorepos, agents, Node.js 22.5+ and the MIT license.

## Agent setup guides

- [Agents that work with Graph Indexer](https://graph-indexer.vercel.app/agents.md): Graph Indexer works with 10 AI coding agents over MCP, including Claude Code, Cursor, Copilot and Codex. npx graph-indexer init writes each agent's config.
- [Graph Indexer for Claude Code](https://graph-indexer.vercel.app/agents/claude-code.md): Add Graph Indexer to Claude Code with npx graph-indexer init: it writes .mcp.json, a CLAUDE.md block and a small-model helper sub-agent. Hooks are optional.
- [Graph Indexer for Cursor](https://graph-indexer.vercel.app/agents/cursor.md): Add Graph Indexer to Cursor with npx graph-indexer init: it writes .cursor/mcp.json so Cursor gets exact references and call graphs from a local index.
- [Graph Indexer for VS Code Copilot](https://graph-indexer.vercel.app/agents/vscode-copilot.md): Add Graph Indexer to VS Code Copilot agent mode with npx graph-indexer init, which writes .vscode/mcp.json using the servers key for exact code references.
- [Graph Indexer for Codex CLI](https://graph-indexer.vercel.app/agents/codex.md): Add Graph Indexer to Codex CLI: init prints the [mcp_servers] TOML block for ~/.codex/config.toml and writes the AGENTS.md lookup rules Codex reads.
- [Graph Indexer for Gemini CLI](https://graph-indexer.vercel.app/agents/gemini-cli.md): Add Graph Indexer to Gemini CLI with npx graph-indexer init, which writes .gemini/settings.json. Tool schemas skip const and additionalProperties.
- [Graph Indexer for OpenCode](https://graph-indexer.vercel.app/agents/opencode.md): Add Graph Indexer to OpenCode with npx graph-indexer init: it writes opencode.json and an optional plugin so OpenCode gets exact references locally.
- [Graph Indexer for Kilo Code](https://graph-indexer.vercel.app/agents/kilo-code.md): Add Graph Indexer to Kilo Code with npx graph-indexer init: it merges the server into kilo.json or opencode.json and installs a .kilo plugin with --hooks.
- [Graph Indexer for Junie](https://graph-indexer.vercel.app/agents/junie.md): Add Graph Indexer to JetBrains Junie with npx graph-indexer init: it writes .junie/mcp/mcp.json so Junie gets exact references and call graphs locally.
- [Graph Indexer for Zed](https://graph-indexer.vercel.app/agents/zed.md): Add Graph Indexer to Zed with npx graph-indexer init: it writes a context_servers entry to .zed/settings.json so Zed's agent gets exact code references.
- [Graph Indexer for Devin](https://graph-indexer.vercel.app/agents/devin.md): Add Graph Indexer to Devin Desktop and Devin CLI: init prints the MCP server entry, writes AGENTS.md and, with --hooks, the Claude Code hooks Devin runs.

## Proof and comparisons

- [Graph Indexer benchmarks](https://graph-indexer.vercel.app/benchmarks.md): Graph Indexer benchmarks: 99.7% reference precision against the TypeScript compiler (grep: 12.8%), 12/12 exact agent answers and 33% cheaper than grep alone.
- [Graph Indexer vs grep for AI coding agents](https://graph-indexer.vercel.app/graph-indexer-vs-grep.md): Graph Indexer vs grep: a name search gives 12.8% real references on nestjs, Graph Indexer 99.7%. Side-by-side table and when grep is still the right tool.

## Source and package

- [GitHub](https://github.com/MaquinaTech/graph-indexer): source, issues, MIT license
- [npm](https://www.npmjs.com/package/graph-indexer): the graph-indexer package
- [Claude Code plugin](https://github.com/MaquinaTech/graph-indexer/tree/main/integrations/claude-code): `/plugin marketplace add MaquinaTech/graph-indexer` then `/plugin install graph-indexer@graph-indexer`
- [Changelog](https://github.com/MaquinaTech/graph-indexer/blob/main/CHANGELOG.md): release notes
- [Benchmarks (source tables)](https://github.com/MaquinaTech/graph-indexer/blob/main/docs/BENCHMARKS.md) and [agentic benchmark](https://github.com/MaquinaTech/graph-indexer/blob/main/docs/AGENTIC-BENCHMARK.md)

## Documentación (español)

- [Instalar Graph Indexer](https://graph-indexer.vercel.app/es/install.md): Instala Graph Indexer con npx graph-indexer init: requiere Node.js 22.5+, conecta el servidor MCP a tus agentes de IA y crea un índice de código local.
- [Plugin de Graph Indexer para Claude Code](https://graph-indexer.vercel.app/es/claude-code-plugin.md): Instala el plugin de Graph Indexer para Claude Code con dos comandos. Incluye el servidor MCP, tres hooks y el sub-agente code-structure, todo en local.
- [Las 8 herramientas MCP de Graph Indexer](https://graph-indexer.vercel.app/es/tools.md): Referencia de las 8 herramientas MCP de solo lectura de Graph Indexer: find_references, change_impact, call_graph y más, con parámetros y ejemplos.
- [Cómo funciona Graph Indexer](https://graph-indexer.vercel.app/es/how-it-works.md): Cómo construye Graph Indexer un grafo de código: parseo tree-sitter WASM, enlace de referencias, índice SQLite local, resincronización y sin embeddings.
- [Lenguajes que soporta Graph Indexer](https://graph-indexer.vercel.app/es/languages.md): Graph Indexer analiza 16 gramáticas tree-sitter incluidas (TypeScript, Python, Go, Java, C#, Rust, Kotlin y más), con enlace profundo de referencias en 7.
- [Preguntas frecuentes de Graph Indexer](https://graph-indexer.vercel.app/es/faq.md): Respuestas sobre Graph Indexer: qué es, en qué se diferencia de grep, privacidad, coste, velocidad, lenguajes, monorepos y agentes, Node 22.5+ y MIT.

## Guías por agente (español)

- [Agentes compatibles con Graph Indexer](https://graph-indexer.vercel.app/es/agents.md): Graph Indexer funciona con 10 agentes de IA vía MCP, como Claude Code, Cursor, Copilot y Codex. npx graph-indexer init escribe la configuración de cada uno.
- [Graph Indexer para Claude Code](https://graph-indexer.vercel.app/es/agents/claude-code.md): Añade Graph Indexer a Claude Code con npx graph-indexer init: escribe .mcp.json, un bloque en CLAUDE.md y un subagente de modelo pequeño. Hooks opcionales.
- [Graph Indexer para Cursor](https://graph-indexer.vercel.app/es/agents/cursor.md): Añade Graph Indexer a Cursor con npx graph-indexer init: escribe .cursor/mcp.json y Cursor obtiene referencias exactas y grafos de llamadas de un índice local
- [Graph Indexer para VS Code Copilot](https://graph-indexer.vercel.app/es/agents/vscode-copilot.md): Añade Graph Indexer al modo agente de Copilot en VS Code con npx graph-indexer init, que escribe .vscode/mcp.json con la clave servers para referencias.
- [Graph Indexer para Codex CLI](https://graph-indexer.vercel.app/es/agents/codex.md): Añade Graph Indexer a Codex CLI: init imprime el bloque [mcp_servers] para ~/.codex/config.toml y escribe en AGENTS.md las reglas de búsqueda que Codex lee.
- [Graph Indexer para Gemini CLI](https://graph-indexer.vercel.app/es/agents/gemini-cli.md): Añade Graph Indexer a Gemini CLI con npx graph-indexer init, que escribe .gemini/settings.json. Sus esquemas evitan const y additionalProperties.
- [Graph Indexer para OpenCode](https://graph-indexer.vercel.app/es/agents/opencode.md): Añade Graph Indexer a OpenCode con npx graph-indexer init: escribe opencode.json y un plugin opcional para que OpenCode obtenga referencias exactas.
- [Graph Indexer para Kilo Code](https://graph-indexer.vercel.app/es/agents/kilo-code.md): Añade Graph Indexer a Kilo Code con npx graph-indexer init: fusiona el servidor en kilo.json u opencode.json e instala un plugin en .kilo con --hooks.
- [Graph Indexer para Junie](https://graph-indexer.vercel.app/es/agents/junie.md): Añade Graph Indexer a JetBrains Junie con npx graph-indexer init: escribe .junie/mcp/mcp.json y Junie obtiene referencias exactas y grafo de llamadas.
- [Graph Indexer para Zed](https://graph-indexer.vercel.app/es/agents/zed.md): Añade Graph Indexer a Zed con npx graph-indexer init: escribe una entrada context_servers en .zed/settings.json y Zed obtiene referencias exactas.
- [Graph Indexer para Devin](https://graph-indexer.vercel.app/es/agents/devin.md): Añade Graph Indexer a Devin Desktop y Devin CLI: init imprime el servidor MCP, escribe AGENTS.md y, con --hooks, los hooks de Claude Code que Devin ejecuta.

## Pruebas y comparativas (español)

- [Benchmarks de Graph Indexer](https://graph-indexer.vercel.app/es/benchmarks.md): Benchmarks de Graph Indexer: 99,7 % de precisión en referencias vs el compilador de TypeScript (grep: 12,8 %) y agentes un 33 % más baratos que grep.
- [Graph Indexer vs grep para agentes de IA](https://graph-indexer.vercel.app/es/graph-indexer-vs-grep.md): Graph Indexer vs grep: una búsqueda por nombre acierta un 12,8 % en nestjs, Graph Indexer un 99,7 %. Comparativa y cuándo grep sigue siendo útil.

## Optional

- [Full text of every English page](https://graph-indexer.vercel.app/llms-full.txt): all docs, guides and benchmark tables in one file
- [Home page as Markdown](https://graph-indexer.vercel.app/index.md) · [Página de inicio en Markdown](https://graph-indexer.vercel.app/es/index.md)