Skip to content

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

Released under the MIT License.