Repomix

^{Special thanks to:}

Warp, built for coding with multiple AI agents
Available for MacOS, Linux, & Windows

CodeRabbit | AI Code Reviews
Cut code review time & bugs in half, instantly.

Please consider sponsoring me.

🏆 Nominación a los Open Source Awards ​

¡Estamos honrados! Repomix ha sido nominado en la categoría Powered by AI en los JSNation Open Source Awards 2025.

¡Esto no habría sido posible sin todos ustedes que usan y apoyan Repomix. ¡Gracias!

¿Qué es Repomix? ​

Repomix es una herramienta poderosa que empaqueta toda tu base de código en un solo archivo compatible con IA. Ya sea que estés trabajando en revisiones de código, refactoring o necesites asistencia de IA para tu proyecto, Repomix facilita compartir todo el contexto de tu repositorio con herramientas de IA.

Inicio rápido ​

Una vez que hayas generado un archivo empaquetado (repomix-output.xml) usando Repomix, puedes enviarlo a un asistente de IA (como ChatGPT, Claude) con un prompt como:

Este archivo contiene todos los archivos del repositorio combinados en uno.
Quiero refactorizar el código, así que por favor revísalo primero.

La IA analizará todo tu código y proporcionará información completa:

Al discutir cambios específicos, la IA puede ayudar a generar código. Con funciones como los Artefactos de Claude, incluso puedes recibir múltiples archivos interdependientes:

¡Feliz programación! 🚀

¿Por qué Repomix? ​

Repomix se puede usar con cualquier servicio de suscripción como ChatGPT, Claude, Gemini o Grok sin preocuparte por costos adicionales. Al proporcionar el contexto completo de tu código, elimina la necesidad de explorar archivos uno por uno, haciendo el análisis más rápido y preciso.

Con todo el código disponible como contexto, Repomix permite una amplia variedad de usos: planificación de implementaciones, investigación de bugs, auditorías de seguridad de bibliotecas de terceros, generación de documentación y mucho más.

Usando la herramienta CLI ​

Repomix puede usarse como una herramienta de línea de comandos, ofreciendo potentes funciones y opciones de personalización.

La herramienta CLI puede acceder a repositorios privados ya que utiliza tu Git instalado localmente.

Inicio rápido ​

Puedes probar Repomix instantáneamente en el directorio de tu proyecto sin necesidad de instalación:

npx repomix@latest

O instalarlo globalmente para uso repetido:

# Instalar usando npm
npm install -g repomix

# O con yarn
yarn global add repomix

# O con bun
bun add -g repomix

# O con Homebrew (macOS/Linux)
brew install repomix

# Luego ejecutar en cualquier directorio de proyecto
repomix

¡Eso es todo! Repomix generará un archivo repomix-output.xml en tu directorio actual, que contendrá todo tu repositorio en un formato amigable para la IA.

Uso ​

Para empaquetar todo tu repositorio:

repomix

Para empaquetar un directorio específico:

repomix ruta/al/directorio

Para empaquetar archivos o directorios específicos usando patrones glob:

repomix --include "src/**/*.ts,**/*.md"

Para excluir archivos o directorios específicos:

repomix --ignore "**/*.log,tmp/"

Para empaquetar un repositorio remoto:

# Usando formato abreviado
npx repomix --remote yamadashy/repomix

# Usando URL completa (soporta ramas y rutas específicas)
npx repomix --remote https://github.com/yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix/tree/main

# Usando URL del commit
npx repomix --remote https://github.com/yamadashy/repomix/commit/836abcd7335137228ad77feb28655d85712680f1

Para inicializar un nuevo archivo de configuración (repomix.config.json):

repomix --init

Una vez que hayas generado el archivo empaquetado, puedes usarlo con herramientas de IA generativa como Claude, ChatGPT y Gemini.

Uso de Docker ​

También puedes ejecutar Repomix usando Docker 🐳
Esto es útil si deseas ejecutar Repomix en un entorno aislado o prefieres usar contenedores.

Uso básico (directorio actual):

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

Para empaquetar un directorio específico:

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix ruta/al/directorio

Procesar un repositorio remoto y generar la salida en un directorio output:

docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix

Formatos de salida ​

Elige tu formato de salida preferido:

# Formato XML (predeterminado)
repomix --style xml

# Formato Markdown
repomix --style markdown

# Formato JSON
repomix --style json

# Formato de texto plano
repomix --style plain

Personalización ​

Crea un archivo repomix.config.json para configuraciones persistentes:

{
  "output": {
    "style": "markdown",
    "filePath": "custom-output.md",
    "removeComments": true,
    "showLineNumbers": true,
    "topFilesLength": 10
  },
  "ignore": {
    "customPatterns": ["*.test.ts", "docs/**"]
  }
}

Casos de Uso del Mundo Real ​

Flujo de Trabajo de Generación de Código con LLM ​

Un desarrollador comparte cómo usa Repomix para extraer contexto de código de bases de código existentes, y luego aprovecha ese contexto con LLMs como Claude y Aider para mejoras incrementales, revisiones de código y generación automatizada de documentación.

Creación de Paquetes de Conocimiento para LLMs ​

Los autores están usando Repomix para empaquetar su contenido escrito—blogs, documentación y libros—en formatos compatibles con LLM, permitiendo a los lectores interactuar con su experiencia a través de sistemas de preguntas y respuestas impulsados por IA.

Descubrir más casos de uso →

Guía para Usuarios Avanzados ​

Repomix ofrece características poderosas para casos de uso avanzados. Aquí tienes algunas guías esenciales para usuarios avanzados:

• Servidor MCP - Integración del Protocolo de Contexto de Modelo para asistentes de IA
• GitHub Actions - Automatiza el empaquetado de código base en flujos de trabajo CI/CD
• Compresión de Código - Compresión inteligente basada en Tree-sitter (~70% de reducción de tokens)
• Usar como Biblioteca - Integra Repomix en tus aplicaciones Node.js
• Instrucciones Personalizadas - Añade prompts e instrucciones personalizadas a las salidas
• Características de Seguridad - Integración incorporada de Secretlint y verificaciones de seguridad
• Mejores Prácticas - Optimiza tus flujos de trabajo de IA con estrategias probadas

Más ejemplos ​