FAQ y solución de problemas
Esta página ayuda a elegir el flujo de trabajo adecuado de Repomix, reducir salidas grandes y preparar contexto de código para asistentes de IA.
Preguntas frecuentes
¿Para qué sirve Repomix?
Repomix empaqueta un repositorio en un único archivo amigable para IA. Esto permite compartir contexto completo de la base de código con ChatGPT, Claude, Gemini u otros asistentes para revisiones, depuración, refactorización, documentación y onboarding.
¿Funciona Repomix con repositorios privados?
Sí. Ejecuta Repomix localmente dentro de un checkout al que tu máquina ya tenga acceso:
repomixRevisa el archivo generado antes de compartirlo con cualquier servicio externo de IA.
¿Puede procesar repositorios públicos de GitHub sin clonarlos?
Sí. Usa --remote con la forma corta o una URL completa:
npx repomix --remote yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix¿Qué formato de salida debería usar?
Usa XML por defecto. Usa Markdown para conversaciones legibles, JSON para automatización y texto plano para máxima compatibilidad. Cambia el formato con --style:
repomix --style markdown
repomix --style jsonConsulta Formatos de salida.
Reducir tokens
El archivo generado es demasiado grande. ¿Qué hago?
Reduce el contexto:
repomix --include "src/**/*.ts,docs/**/*.md"
repomix --ignore "**/*.test.ts,dist/**"
repomix --compress
repomix --remove-commentsCombina patrones include e ignore con compresión de código en repositorios grandes.
¿Qué hace --compress?
--compress conserva estructura importante como imports, exports, clases, funciones e interfaces, pero elimina muchos detalles de implementación. Es útil cuando el modelo necesita entender la arquitectura.
Seguridad y privacidad
¿La CLI sube mi código?
La CLI de Repomix se ejecuta localmente y escribe un archivo de salida en tu máquina. El sitio web y la extensión del navegador tienen flujos distintos; consulta la Política de privacidad.
¿Cómo evita Repomix incluir secretos?
Repomix usa controles basados en Secretlint. Trátalos como una capa adicional y revisa siempre la salida.
Solución de problemas
¿Por qué faltan archivos en la salida?
Repomix respeta .gitignore, reglas ignore predeterminadas y patrones personalizados. Revisa repomix.config.json, --ignore y las reglas de git.
¿Cómo hago que la salida sea reproducible en equipo?
Crea y versiona una configuración compartida:
repomix --initPreguntas frecuentes adicionales
¿Repomix funciona con C#, Python, Java, Go, Rust u otros lenguajes?
Sí. Repomix lee los archivos de tu proyecto y los formatea para herramientas de IA, por lo que puede empaquetar repositorios escritos en cualquier lenguaje. La CLI requiere Node.js 20 o posterior. Algunas funciones avanzadas, como la compresión basada en Tree-sitter, dependen del soporte de parser para cada lenguaje.
¿Puedo usar Repomix con Hermes Agent, OpenClaw u otros agentes compatibles con MCP?
Sí. Repomix puede ejecutarse como servidor MCP:
npx -y repomix --mcpEn Hermes Agent, añade Repomix como servidor MCP stdio en ~/.hermes/config.yaml:
mcp_servers:
repomix:
command: "npx"
args: ["-y", "repomix", "--mcp"]En OpenClaw u otros agentes compatibles con MCP, usa el mismo command y args donde el agente permita configurar un servidor MCP stdio externo. Si tu asistente soporta Agent Skills, también puedes usar Repomix Explorer Skill.
¿Cómo uso Repomix para ayudar a un asistente de IA a entender una nueva librería o framework?
Empaqueta el repositorio de la librería o su documentación y entrega la salida al asistente como material de referencia:
npx repomix --remote owner/repo
npx repomix --remote owner/repo --include "docs/**,src/**"Para uso repetido, puedes generar un directorio Agent Skills reutilizable:
npx repomix --remote owner/repo --skill-generate library-reference¿Cómo excluyo CSS, tests, build output u otros archivos ruidosos?
Usa --ignore para comandos puntuales:
repomix --ignore "**/*.css,**/*.test.ts,dist/**,coverage/**"Usa --include cuando quieras conservar solo rutas específicas de código o documentación:
repomix --include "src/**/*.ts,docs/**/*.md"¿Hay un límite de tamaño de repositorio?
La CLI no tiene un límite fijo de tamaño de repositorio, pero los repositorios muy grandes pueden verse limitados por memoria, tamaño de archivo o límites de carga y contexto de la herramienta de IA. Para proyectos grandes, empieza con patrones include específicos, revisa los archivos con más tokens y divide la salida si es necesario:
repomix --token-count-tree 1000
repomix --split-output 1mb¿Por qué --include no incluye archivos de node_modules, directorios de build o rutas ignoradas?
--include reduce los archivos que Repomix intenta empaquetar, pero las reglas de ignore siguen aplicándose. Los archivos pueden excluirse por .gitignore, .ignore, .repomixignore, patrones predeterminados integrados o repomix.config.json. En casos avanzados puedes usar --no-gitignore o --no-default-patterns, pero hazlo con cuidado porque pueden incluir dependencias, artefactos de build u otros archivos ruidosos.