Repomix: Convierte Todo Tu Repositorio en Contexto para Cualquier IA
Alguna vez intentaste pedirle a Claude, ChatGPT o Gemini que te ayudara a depurar un bug que tocaba cuatro archivos diferentes — y terminaste pegando archivos uno por uno durante diez minutos antes de que la IA pudiera empezar a razonar sobre el problema.
Ese es exactamente el problema que resuelve Repomix: meter tu repositorio completo en un solo archivo limpio, estructurado, listo para ser consumido por cualquier IA.
Sin copiar y pegar. Sin perder conexiones entre archivos. Sin que el modelo pierda el hilo.
El problema que nadie te resuelve por ti
Las herramientas de IA para código son muy buenas dentro de una ventana. Son malas razonando sobre tu proyecto completo — no por falta de capacidad, sino por falta de visibilidad.
Cursor ve los archivos que tienes abiertos. Claude.ai ve lo que le pegues. GitHub Copilot ve el archivo actual. Ninguno entiende automáticamente cómo tu middleware de autenticación se conecta con tus rutas de API se conecta con tus context providers. Esa imagen la tienes que construir tú para ellos.
Repomix la construye por ti.
Un solo comando
npx repomix
Eso es todo. Ejecutalo en tu directorio de proyecto y genera un archivo repomix-output.xml con todo tu repositorio en un formato estructurado y optimizado para LLMs. El archivo comienza con una explicación orientada al modelo, luego organiza tu código de forma jerárquica — así la IA no recibe un volcado de texto, sino una representación coherente de tu proyecto.
Si lo vas a usar con frecuencia, instálalo globalmente:
npm install -g repomix
# o con Homebrew (macOS/Linux)
brew install repomix
Qué lo hace realmente útil
Conteo de tokens. Antes de pegar nada, Repomix te muestra exactamente cuántos tokens usa cada archivo y el total completo. Sin más adivinanzas sobre si tu proyecto va a reventar la ventana de contexto de Claude.
Respeta tu .gitignore. Excluye automáticamente lo que ya le dijiste a git que ignore — node_modules, artefactos de build, archivos de entorno. Puedes agregar un .repomixignore para control adicional.
Seguridad integrada. Repomix integra Secretlint para detectar API keys, tokens o credenciales hardcodeadas antes de que terminen en tu contexto de IA. Importante cuando estás a punto de pegar un archivo en una interfaz de terceros.
El flag --compress. Usa Tree-sitter para recortar el boilerplate de forma inteligente y reducir el conteo de tokens en aproximadamente 70%, preservando la estructura que importa. Para repositorios grandes, esta es la diferencia entre entrar en contexto o no.
repomix --compress
Repositorios remotos. Puedes empaquetar cualquier repositorio público de GitHub sin necesidad de clonarlo:
repomix --remote owner/repo
Útil para hacer auditorías de seguridad, entender librerías de terceros, o pasarle el código fuente de una dependencia directamente a tu IA para un análisis más profundo.
Flujos de trabajo prácticos
Debugging complejo: Pega el output completo en Claude o ChatGPT con: “Aquí está todo mi repositorio. Mi flujo de autenticación falla cuando los usuarios inician sesión con Google — traza el flujo e identifica el problema.” La IA ahora puede ver cada archivo, cada dependencia, cada conexión.
Refactorización: “Revisa este proyecto y propón un plan de migración de REST a tRPC.” Tiene el contexto para darte una respuesta real, no una genérica.
Generación de documentación: Pasa tu proyecto completo y pide un README actualizado, documentación de API, o un overview de arquitectura.
Code review antes de un PR: Ejecuta Repomix, pega en tu LLM favorito, pide una revisión comprehensiva. Cada archivo se revisa en conjunto, no en aislamiento.
El servidor MCP
Para una experiencia más integrada, Repomix también funciona como servidor MCP — lo que significa que puedes usarlo directamente dentro de Claude Code, Claude Desktop, o cualquier cliente compatible con MCP:
npx repomix --mcp
Esto permite que tu asistente de IA consulte tu repositorio a través de Repomix de forma interactiva, en lugar de recibir un archivo estático. Más dinámico, y útil para sesiones largas donde el código cambia mientras trabajas.
Por qué importa que sea model-agnostic
Vale la pena decirlo explícitamente: Repomix no le importa qué IA estás usando. El output funciona con Claude, ChatGPT, Gemini, DeepSeek, Perplexity, Grok, Llama, o cualquier modelo local que estés corriendo a través de LM Studio u Ollama.
También significa que puedes comparar cómo distintos modelos manejan el mismo repositorio. Corre el mismo prompt contra Claude y Gemini y ve cuál da mejor consejo arquitectónico para tu stack específico.
Repomix fue nominado en la categoría “Powered by AI” de los JSNation Open Source Awards 2025 — un reconocimiento que refleja bien la tracción que ha ganado en la comunidad.
Links
- Website: repomix.com
- GitHub: yamadashy/repomix
- Docs: repomix.com/guide