# Mapa del proyecto

URL: https://agentvera.dev/es/features/project-map/ · Plan: Gratis

Cuando un agente empieza una tarea nueva, suele hacer grep primero y luego leer archivos uno por uno. El mapa del proyecto acorta esa búsqueda: AgentVera indexa en tu ordenador los símbolos, los imports y los archivos que cambian juntos, y los agentes piden a las herramientas MCP de agentvera-map los archivos relevantes, quién los usa y sus tests.

**Qué se indexa.** El mapa se construye con tree-sitter. En archivos TypeScript, TSX, JavaScript, Python y Go se extraen funciones, clases, métodos, interfaces, tipos, enums y constantes con sus rangos de líneas, firmas y la primera frase de su documentación. Unos 30 lenguajes más, como Rust, Java, PHP y Ruby, entran en el mapa por la ruta del archivo.

- Los imports se resuelven a archivos del proyecto; los tests se enlazan con los archivos que importan y con los archivos fuente de nombre coincidente.
- Cambian juntos: se emparejan los archivos que cambiaron juntos en al menos dos de los últimos 500 commits; se ignoran los commits que tocan más de 40 archivos.
- Los archivos se obtienen con git ls-files y se respeta .gitignore; se omiten carpetas como node_modules, dist y build, archivos de más de 1 MB y archivos generados y minificados.
- En repositorios con más de 20.000 archivos solo se indexan las carpetas de código fuente (src, lib, app, packages/*/src…).

**Las herramientas de agentvera-map.** El mapa se añade al agente como servidor MCP. Sus instrucciones le dicen al agente que empiece una tarea con map_related, que consulte map_outline antes de leer un archivo y map_usages antes de cambiar código. Las instrucciones de un agente nuevo incluyen además un breve resumen de los módulos del proyecto, sus puntos de entrada y el comando de tests.

- map_related: los archivos que una tarea probablemente implica, ordenados con sus motivos. Las palabras de tarea en turco (sepet, kupon, ödeme…) también coinciden con sus nombres en inglés en el código.
- map_outline: los símbolos de un archivo con sus rangos de líneas, cuántos archivos lo importan y sus tests.
- map_usages: dónde se define y se llama un símbolo, los archivos que lo importan y sus tests; para un archivo, sus importadores y los importadores de estos.
- map_find: búsqueda aproximada en nombres de símbolos y archivos, con tipo, archivo:línea y firma.
- map_overview: módulos, puntos de entrada y el comando de tests. map_api lee la API real de la versión instalada de un paquete en node_modules a partir de sus archivos .d.ts.

**Actualizado y local.** Hay un mapa por carpeta (un proyecto o un worktree), compartido por todos los agentes que trabajan ahí. Se vigilan los cambios de archivos, los commits provocan un nuevo recuento de los archivos que cambian juntos, y un archivo por el que pregunta un agente se vuelve a comprobar antes de responder. El mapa se construye en tu ordenador y no cuesta tokens; cada agente solo puede leer el mapa de su propia carpeta.

**Grafo e impacto.** La pestaña Project map de la página Details de un proyecto dibuja los archivos como un grafo coloreado por módulo: imports en gris, archivos que cambian juntos como líneas naranjas discontinuas. Escribe una tarea y pulsa «Show» para ver los archivos que miraría un agente, con sus motivos. La tarjeta «Project map impact» de la pestaña AI ROI compara las conversaciones que usaron el mapa con las que no, por éxito, aprobación a la primera, tokens por tarea y repeticiones.

**Cómo activarlo:**

1. Comprueba que el interruptor «Project map» en Settings → Token savings esté activado; lo está por defecto.
2. Abre el proyecto o inicia un agente: el mapa se construye una vez y después sigue los cambios.
3. Mira el grafo en Details → Project map y escribe una tarea para ver qué archivos miraría un agente.
4. Para dejarlo fuera en un agente, desmarca la casilla «Project map» en el diálogo de edición de ese agente.

- **¿Qué agentes usan el mapa?** Todos los agentes CLI que admiten servidores MCP: Claude Code, Codex, opencode, Copilot, Gemini, Cursor y el resto. No se añade a los agentes en hosts remotos (SSH).
- **¿El mapa envía mi código a algún sitio?** No. El mapa se construye en tu ordenador y se guarda comprimido en la carpeta de datos de la app. Lo que un agente lee de la respuesta de una herramienta llega a su propio proveedor de modelo, como cualquier otra cosa que lea.
- **¿Qué lenguajes tienen símbolos?** TypeScript, TSX, JavaScript, Python y Go. Los archivos de otros lenguajes están en el mapa por su ruta y con sus enlaces de cambio conjunto.
- **¿Y si el mapa aún no está listo?** Las respuestas indican cuánto ha avanzado el mapa. El agente espera unos segundos como máximo y luego se le dice que siga con sus herramientas habituales.
- **¿En qué se diferencia del mapa de código?** La ventana del mapa de código te muestra las dependencias entre módulos y los archivos que más tocan los agentes. El mapa del proyecto es un índice vivo que los propios agentes consultan.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/