⚡ RepoContext

El motor de mapas de código AST, compresión de tokens y empaquetado de contexto de nueva generación para agentes de codificación con IA e IDEs.

English | 中文说明

🌟 ¿Por qué RepoContext?

Al introducir bases de código en los asistentes de codificación con IA modernos (Claude Code, Cursor, Windsurf, OpenAI Codex, Antigravity, Cline), los desarrolladores se enfrentan a tres cuellos de botella críticos:

1. 💥 Explosión de tokens y altos costes de API: Los volcados de código en bruto superan rápidamente los límites de contexto o cuestan decenas de dólares por consulta.

2. 📉 Baja relación señal-ruido: El 80% de las líneas son detalles de implementación rutinarios. Los LLM solo necesitan la superficie semántica de la API (firmas, tipos, interfaces, docstrings).

3. 🔓 Fugas de seguridad: Exposición accidental de credenciales de .env, claves de API y URI de bases de datos en los prompts.

RepoContext resuelve los tres con poda inteligente de esquemas AST, clasificación semántica de archivos centrada en la tarea, redacción automática de credenciales e integración nativa con Model Context Protocol (MCP).

Related MCP server: AtlasMemory

🚀 Características principales

• ⚡ Mapa AST de la base de código y esqueletizador: Comprime los archivos fuente en un 70%~85% conservando el 100% de las interfaces, tipos, funciones y JSDoc/docstrings.

• 🎯 Poda de relevancia orientada a tareas: Pasa tu consulta de prompt (p. ej. repocontext pack -q "Fix JWT auth token expiry") para clasificar y empaquetar automáticamente solo los archivos más críticos.

• 🛡️ Escáner automático de secretos y redacción: El escáner integrado de entropía y regex detecta y enmascara claves de OpenAI, tokens de GitHub, claves de AWS, JWT y URI de bases de datos.

• 🔌 Servidor nativo de Model Context Protocol (MCP): Se integra directamente con Claude Desktop, Cursor, Windsurf y Antigravity mediante las herramientas estándar de MCP.

• 📑 Exportación multiformato: Genera Markdown limpio con árboles de directorios, XML optimizado para Claude (<documents>) o JSON estructurado.

• 📊 Analítica de tokens y costes multimodelo: Contador de tokens en tiempo real con estimaciones de coste para GPT-4o, GPT-5, Claude 3.5 Sonnet y Gemini 1.5 Pro.

📦 Inicio rápido

1. Ejecutar sin instalación mediante npx

# Pack entire repository into an optimized Markdown prompt
npx repocontext pack

# Pack only files relevant to a specific task prompt
npx repocontext pack -q "Implement Stripe payment webhook handler" -o prompt.md

# Generate lightweight AST skeleton map (75%+ token reduction)
npx repocontext map -o codebase-map.md

2. Instalación global

npm install -g repocontext

🛠️ Uso y opciones de la CLI

repocontext pack [dir] [options]

Options:
  -m, --mode <mode>         Packing mode: full | ast | relevant | hybrid (default: "full")
  -q, --query <query>       Filter and rank files relevant to a coding task prompt
  -f, --format <format>     Output format: markdown | xml | json (default: "markdown")
  -o, --output <file>       Output file path (default: "repocontext-output.md")
  -t, --max-tokens <number> Maximum token budget ceiling (default: 80000)
  --no-security             Disable secret scanning and auto-redaction
  -h, --help                Display help for command

🔌 Integración con Model Context Protocol (MCP)

RepoContext incluye soporte integrado de servidor MCP. Añádelo a tu claude_desktop_config.json o a la configuración MCP de Cursor/Windsurf:

{
  "mcpServers": {
    "repocontext": {
      "command": "npx",
      "args": ["-y", "repocontext", "mcp"]
    }
  }
}

Herramientas MCP expuestas:

• get_codebase_map: Devuelve el mapa esquemático de símbolos AST del repositorio.

• extract_relevant_context: Poda la base de código y devuelve solo los archivos necesarios para un prompt.

• read_file_outline: Lee el esqueleto AST comprimido de un solo archivo.

📊 Benchmark y comparación

🤝 Contribuciones

¡Las contribuciones, las incidencias y las solicitudes de funcionalidades son bienvenidas! No dudes en consultar la página de incidencias.

📄 Licencia

Este proyecto está bajo licencia MIT.