Repomix

# Uso básico ## Inicio rápido Empaqueta todo tu repositorio: ```bash repomix ``` ## Casos de uso comunes ### Empaquetar directorios específicos ```bash repomix ruta/al/directorio ``` ### Incluir archivos específicos Usa [patrones glob](https://github.com/mrmlnc/fast-glob?tab=readme-ov-file#pattern-syntax): ```bash repomix --include "src/**/*.ts,**/*.md" ``` ### Excluir archivos ```bash repomix --ignore "**/*.log,tmp/" ``` ### Dividir Salida en Múltiples Archivos Al trabajar con grandes bases de código, la salida empaquetada puede exceder los límites de tamaño de archivo impuestos por algunas herramientas de IA (por ejemplo, el límite de 1MB de Google AI Studio). Use `--split-output` para dividir automáticamente la salida en múltiples archivos: ```bash repomix --split-output 1mb ``` Esto genera archivos numerados como: - `repomix-output.1.xml` - `repomix-output.2.xml` - `repomix-output.3.xml` El tamaño se puede especificar con unidades: `500kb`, `1mb`, `2mb`, `1.5mb`, etc. Se admiten valores decimales. > [!NOTE] > Los archivos se agrupan por directorio de nivel superior para mantener el contexto. Un solo archivo o directorio nunca se dividirá entre múltiples archivos de salida. ### Repositorios remotos ```bash # Usando la URL de GitHub repomix --remote https://github.com/usuario/repositorio # Usando la abreviatura repomix --remote usuario/repositorio # Rama/etiqueta/commit específico repomix --remote usuario/repositorio --remote-branch main repomix --remote usuario/repositorio --remote-branch 935b695 ``` ### Entrada de lista de archivos (stdin) Pasa rutas de archivos a través de stdin para máxima flexibilidad: ```bash # Usando el comando find find src -name "*.ts" -type f | repomix --stdin # Usando git para obtener archivos rastreados git ls-files "*.ts" | repomix --stdin # Usando ripgrep (rg) para encontrar archivos rg --files --type ts | repomix --stdin # Usando grep para encontrar archivos que contienen contenido específico grep -l "TODO" **/*.ts | repomix --stdin # Usando ripgrep para encontrar archivos con contenido específico rg -l "TODO|FIXME" --type ts | repomix --stdin # Usando sharkdp/fd para encontrar archivos fd -e ts | repomix --stdin # Usando fzf para seleccionar de todos los archivos fzf -m | repomix --stdin # Selección interactiva de archivos con fzf find . -name "*.ts" -type f | fzf -m | repomix --stdin # Usando ls con patrones glob ls src/**/*.ts | repomix --stdin # Desde un archivo que contiene rutas de archivos cat file-list.txt | repomix --stdin # Entrada directa con echo echo -e "src/index.ts\nsrc/utils.ts" | repomix --stdin ``` La opción `--stdin` te permite canalizar una lista de rutas de archivos a Repomix, brindando máxima flexibilidad en la selección de qué archivos empaquetar. Cuando se usa `--stdin`, los archivos especificados se agregan efectivamente a los patrones de inclusión. Esto significa que el comportamiento normal de inclusión e ignorar sigue aplicando - los archivos especificados vía stdin aún serán excluidos si coinciden con patrones de ignorar. > [!NOTE] > Cuando uses `--stdin`, las rutas de archivos pueden ser relativas o absolutas, y Repomix manejará automáticamente la resolución de rutas y la eliminación de duplicados. ### Compresión de código ```bash repomix --compress # También puedes usarlo con repositorios remotos: repomix --remote yamadashy/repomix --compress ``` ### Integración con Git Incluye información de Git para proporcionar contexto de desarrollo al análisis de IA: ```bash # Incluir diffs de git (cambios sin commit) repomix --include-diffs # Incluir logs de commits de git (últimos 50 commits por defecto) repomix --include-logs # Incluir número específico de commits repomix --include-logs --include-logs-count 10 # Incluir tanto diffs como logs repomix --include-diffs --include-logs ``` Esto añade contexto valioso sobre: - **Cambios recientes**: Los diffs de Git muestran modificaciones sin commit - **Patrones de desarrollo**: Los logs de Git revelan qué archivos típicamente se cambian juntos - **Historial de commits**: Los mensajes de commit recientes proporcionan información sobre el enfoque de desarrollo - **Relaciones entre archivos**: Entender qué archivos se modifican en los mismos commits ### Optimización del conteo de tokens Entender la distribución de tokens de tu base de código es crucial para optimizar las interacciones con IA. Usa la opción `--token-count-tree` para visualizar el uso de tokens en todo tu proyecto: ```bash repomix --token-count-tree ``` Esto muestra una vista jerárquica de tu base de código con conteos de tokens: ``` 🔢 Token Count Tree: ──────────────────── └── src/ (70,925 tokens) ├── cli/ (12,714 tokens) │ ├── actions/ (7,546 tokens) │ └── reporters/ (990 tokens) └── core/ (41,600 tokens) ├── file/ (10,098 tokens) └── output/ (5,808 tokens) ``` También puedes establecer un umbral mínimo de tokens para enfocarte en archivos más grandes: ```bash repomix --token-count-tree 1000 # Solo mostrar archivos/directorios con 1000+ tokens ``` Esto te ayuda a: - **Identificar archivos pesados en tokens** - que podrían exceder los límites de contexto de IA - **Optimizar la selección de archivos** - usando patrones `--include` e `--ignore` - **Planificar estrategias de compresión** - dirigiéndose a los mayores contribuyentes - **Equilibrar contenido vs contexto** - al preparar código para análisis de IA ## Formatos de salida ### XML (predeterminado) ```bash repomix --style xml ``` ### Markdown ```bash repomix --style markdown ``` ### JSON ```bash repomix --style json ``` ### Texto sin formato ```bash repomix --style plain ``` ## Opciones adicionales ### Eliminar comentarios ```bash repomix --remove-comments ``` ### Mostrar números de línea ```bash repomix --output-show-line-numbers ``` ### Copiar al portapapeles ```bash repomix --copy ``` ### Deshabilitar la verificación de seguridad ```bash repomix --no-security-check ``` ## Configuración Inicializar el archivo de configuración: ```bash repomix --init ``` Consulta la [Guía de configuración](/guide/configuration) para obtener opciones detalladas.