command-line-options.md•5.44 kB
# Opciones de línea de comandos
## Opciones básicas
- `-v, --version`: Mostrar versión de la herramienta
## Opciones de entrada/salida CLI
- `--verbose`: Habilitar registro detallado
- `--quiet`: Deshabilitar toda salida a stdout
- `--stdout`: Salida a stdout en lugar de escribir a un archivo (no se puede usar con la opción `--output`)
- `--stdin`: Leer rutas de archivos desde stdin en lugar de descubrir archivos automáticamente
- `--copy`: Copiar adicionalmente la salida generada al portapapeles del sistema
- `--token-count-tree [threshold]`: Mostrar árbol de archivos con resúmenes de conteo de tokens (opcional: umbral mínimo de conteo de tokens). Útil para identificar archivos grandes y optimizar el uso de tokens para límites de contexto de IA
- `--top-files-len <number>`: Número de archivos más grandes a mostrar en el resumen (por defecto: 5, ej: --top-files-len 20)
## Opciones de salida de Repomix
- `-o, --output <file>`: Ruta del archivo de salida (por defecto: repomix-output.xml, usar "-" para stdout)
- `--style <type>`: Formato de salida: xml, markdown, json o plain (por defecto: xml)
- `--parsable-style`: Habilitar salida parseable basada en el esquema de estilo elegido. Ten en cuenta que esto puede aumentar el conteo de tokens.
- `--compress`: Realizar extracción inteligente de código, enfocándose en firmas esenciales de funciones y clases para reducir el conteo de tokens
- `--output-show-line-numbers`: Mostrar números de línea en la salida
- `--no-file-summary`: Deshabilitar salida de sección de resumen de archivos
- `--no-directory-structure`: Deshabilitar salida de sección de estructura de directorios
- `--no-files`: Deshabilitar salida de contenido de archivos (modo solo metadatos)
- `--remove-comments`: Remover comentarios de tipos de archivos soportados
- `--remove-empty-lines`: Remover líneas vacías de la salida
- `--truncate-base64`: Habilitar truncamiento de cadenas de datos base64
- `--header-text <text>`: Texto personalizado para incluir en el encabezado del archivo
- `--instruction-file-path <path>`: Ruta a un archivo que contiene instrucciones personalizadas detalladas
- `--include-empty-directories`: Incluir directorios vacíos en la salida
- `--include-full-directory-structure`: Mostrar el árbol completo del repositorio en la sección Estructura de directorios, incluso al usar patrones --include
- `--include-diffs`: Incluir diffs de git en la salida (incluye cambios del árbol de trabajo y cambios en stage por separado)
- `--include-logs`: Incluir logs de git en la salida (incluye historial de commits con fechas, mensajes y rutas de archivos)
- `--include-logs-count <count>`: Número de commits de log de git a incluir (predeterminado: 50)
- `--no-git-sort-by-changes`: Deshabilitar ordenamiento de archivos por conteo de cambios de git (habilitado por defecto)
## Opciones de selección de archivos
- `--include <patterns>`: Lista de patrones de inclusión (separados por comas)
- `-i, --ignore <patterns>`: Patrones de ignorar adicionales (separados por comas)
- `--no-gitignore`: Deshabilitar uso de archivo .gitignore
- `--no-default-patterns`: Deshabilitar patrones por defecto
## Opciones de repositorio remoto
- `--remote <url>`: Procesar repositorio remoto
- `--remote-branch <name>`: Especificar nombre de rama remota, etiqueta o hash de commit (por defecto a la rama por defecto del repositorio)
## Opciones de configuración
- `-c, --config <path>`: Ruta de archivo de configuración personalizada
- `--init`: Crear archivo de configuración
- `--global`: Usar configuración global
## Opciones de seguridad
- `--no-security-check`: Omitir escaneo de datos sensibles como claves API y contraseñas
## Opciones de conteo de tokens
- `--token-count-encoding <encoding>`: Modelo tokenizador para conteo: o200k_base (GPT-4o), cl100k_base (GPT-3.5/4), etc. (por defecto: o200k_base)
## Opciones MCP
- `--mcp`: Ejecutar como servidor Model Context Protocol para integración de herramientas de IA
## Ejemplos
```bash
# Uso básico
repomix
# Archivo de salida y formato personalizados
repomix -o my-output.xml --style xml
# Salida a stdout
repomix --stdout > custom-output.txt
# Salida a stdout, luego tubería a otro comando (por ejemplo, simonw/llm)
repomix --stdout | llm "Por favor explica qué hace este código."
# Salida personalizada con compresión
repomix --compress
# Procesar archivos específicos con patrones
repomix --include "src/**/*.ts,*.md" --ignore "*.test.js,docs/**"
# Repositorio remoto con rama
repomix --remote https://github.com/user/repo/tree/main
# Repositorio remoto con commit
repomix --remote https://github.com/user/repo/commit/836abcd7335137228ad77feb28655d85712680f1
# Repositorio remoto con forma abreviada
repomix --remote user/repo
# Lista de archivos usando stdin
find src -name "*.ts" -type f | repomix --stdin
git ls-files "*.js" | repomix --stdin
echo -e "src/index.ts\nsrc/utils.ts" | repomix --stdin
# Integración con Git
repomix --include-diffs # Incluir diffs de git para cambios sin commit
repomix --include-logs # Incluir logs de git (últimos 50 commits por defecto)
repomix --include-logs --include-logs-count 10 # Incluir últimos 10 commits
repomix --include-diffs --include-logs # Incluir tanto diffs como logs
# Análisis de conteo de tokens
repomix --token-count-tree
repomix --token-count-tree 1000 # Solo mostrar archivos/directorios con 1000+ tokens
```