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 principales a mostrar en el resumen

Opciones de salida de Repomix

• -o, --output <file>: Especificar nombre del archivo de salida
• --style <style>: Especificar estilo de salida (xml, markdown, plain)
• --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-diffs: Incluir diffs de git en la salida (incluye cambios del árbol de trabajo y cambios en stage por separado)
• --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: Deshabilitar verificación de seguridad (por defecto: true)

Opciones de conteo de tokens

• --token-count-encoding <encoding>: Especificar codificación de conteo de tokens utilizada por el tokenizador tiktoken de OpenAI (ej., o200k_base para GPT-4o, cl100k_base para GPT-4/3.5). Ver tiktoken model.py para detalles de codificación.

Ejemplos

# Uso básico
repomix

# Salida personalizada
repomix -o 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
repomix --include "src/**/*.ts" --ignore "**/*.test.ts"

# 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

# Análisis de conteo de tokens
repomix --token-count-tree
repomix --token-count-tree 1000  # Solo mostrar archivos/directorios con 1000+ tokens