---
title: "Opciones de línea de comandos"
description: "Consulta todas las opciones de la CLI de Repomix para entrada, salida, selección de archivos, repositorios remotos, configuración, seguridad, conteo de tokens, MCP y Agent Skills."
---

# Opciones de línea de comandos

## Opciones básicas
- `-v, --version`: Mostrar versión de la herramienta

## Opciones de entrada/salida CLI

| Opción | Descripción |
|--------|-------------|
| `--verbose` | Habilitar registro detallado de depuración (muestra procesamiento de archivos, conteo de tokens y detalles de configuración) |
| `--quiet` | Suprimir toda salida de consola excepto errores (útil para scripting) |
| `--stdout` | Escribir salida empaquetada directamente a stdout en lugar de un archivo (suprime todo el registro) |
| `--stdin` | Leer rutas de archivos desde stdin, una por línea (los archivos especificados se procesan directamente) |
| `--copy` | Copiar la salida generada al portapapeles del sistema después del procesamiento |
| `--token-count-tree [threshold]` | Mostrar árbol de archivos con conteo de tokens; umbral opcional para mostrar solo archivos con ≥N tokens (ej: `--token-count-tree 100`) |
| `--top-files-len <number>` | Número de archivos más grandes a mostrar en el resumen (por defecto: `5`) |

## Opciones de salida de Repomix

| Opción | Descripción |
|--------|-------------|
| `-o, --output <file>` | Ruta del archivo de salida (por defecto: `repomix-output.xml`, usar `"-"` para stdout) |
| `--style <style>` | Formato de salida: `xml`, `markdown`, `json` o `plain` (por defecto: `xml`) |
| `--output-file-path-style <style>` | Cómo se muestran las rutas de archivos en la salida: `target-relative` o `cwd-relative` (por defecto: `target-relative`) |
| `--parsable-style` | Escapar caracteres especiales para garantizar XML/Markdown válido (necesario cuando la salida contiene código que rompe el formato) |
| `--compress` | Extraer la estructura esencial del código (clases, funciones, interfaces) usando análisis Tree-sitter |
| `--output-show-line-numbers` | Agregar número de línea a cada línea en la salida |
| `--no-file-summary` | Omitir la sección de resumen de archivos de la salida |
| `--no-directory-structure` | Omitir la visualización del árbol de directorios de la salida |
| `--no-files` | Generar solo metadatos sin contenido de archivos (útil para análisis de repositorio) |
| `--remove-comments` | Eliminar todos los comentarios del código antes de empaquetar |
| `--remove-empty-lines` | Eliminar líneas en blanco de todos los archivos |
| `--truncate-base64` | Truncar cadenas largas de datos base64 para reducir el tamaño de la salida |
| `--header-text <text>` | Texto personalizado para incluir al inicio de la salida |
| `--instruction-file-path <path>` | Ruta a un archivo que contiene instrucciones personalizadas para incluir en la salida |
| `--split-output <size>` | Dividir la salida en múltiples archivos numerados (ej: `repomix-output.1.xml`); tamaño como `500kb`, `2mb` o `1.5mb` |
| `--include-empty-directories` | Incluir carpetas sin archivos en la estructura de directorios |
| `--include-full-directory-structure` | Mostrar el árbol completo del repositorio en la sección Estructura de Directorios, incluso al usar patrones `--include` |
| `--no-git-sort-by-changes` | No ordenar archivos por frecuencia de cambios en git (por defecto: los archivos más modificados primero) |
| `--include-diffs` | Agregar sección de git diff mostrando cambios del árbol de trabajo y cambios en stage |
| `--include-logs` | Agregar historial de commits de git con mensajes y archivos modificados |
| `--include-logs-count <count>` | Número de commits recientes a incluir con `--include-logs` (por defecto: `50`) |

## Opciones de selección de archivos

| Opción | Descripción |
|--------|-------------|
| `--include <patterns>` | Incluir solo archivos que coincidan con estos patrones glob (separados por comas, ej: `"src/**/*.js,*.md"`) |
| `-i, --ignore <patterns>` | Patrones adicionales a excluir (separados por comas, ej: `"*.test.js,docs/**"`) |
| `--no-gitignore` | No usar reglas `.gitignore` para filtrar archivos |
| `--no-dot-ignore` | No usar reglas `.ignore` para filtrar archivos |
| `--no-default-patterns` | No aplicar patrones de exclusión integrados (`node_modules`, `.git`, directorios de compilación, etc.) |

## Opciones de repositorio remoto

| Opción | Descripción |
|--------|-------------|
| `--remote <url>` | Clonar y empaquetar un repositorio remoto (URL de GitHub o formato `user/repo`) |
| `--remote-branch <name>` | Rama, etiqueta o commit específico a usar (por defecto: la rama por defecto del repositorio) |
| `--remote-trust-config` | Confiar y cargar archivos de configuración de repositorios remotos (deshabilitado por defecto por seguridad) |

## Opciones de configuración

| Opción | Descripción |
|--------|-------------|
| `-c, --config <path>` | Usar archivo de configuración personalizado en lugar de `repomix.config.json` |
| `--init` | Crear un nuevo archivo `repomix.config.json` con valores por defecto |
| `--global` | Con `--init`, crear configuración en el directorio home en lugar del directorio actual |

## 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)
- `--token-budget <number>`: Fallar con un código de salida distinto de cero cuando la salida empaquetada supera N tokens. Útil como protección en pipelines de CI y flujos de trabajo de agentes para mantener la salida dentro de la ventana de contexto de un modelo objetivo. La salida se sigue generando; solo el código de salida señala el desbordamiento.

## Opciones MCP
- `--mcp`: Ejecutar como servidor Model Context Protocol para integración de herramientas de IA

## Opciones de generación de Agent Skills

| Opción | Descripción |
|--------|-------------|
| `--skill-generate [name]` | Generar salida en formato Claude Agent Skills en el directorio `.claude/skills/<name>/` (nombre autogenerado si se omite) |
| `--skill-project-name <name>` | Sobrescribir el nombre del proyecto usado en las descripciones de Skills generadas |
| `--skill-output <path>` | Especificar la ruta del directorio de salida de skills directamente (omite la solicitud de ubicación) |
| `-f, --force` | Omitir todas las solicitudes de confirmación (ej: sobrescritura del directorio de skills) |

## Opciones del modo de observación

- `-w, --watch`: Observa los cambios en los archivos y vuelve a empaquetar automáticamente. Se detectan los archivos nuevos, modificados y eliminados, los cambios rápidos se agrupan mediante debounce (300 ms) y se imprime una marca de tiempo después de cada reconstrucción. Pulsa `Ctrl+C` para detener.

El modo de observación solo funciona con directorios locales, por lo que no se puede combinar con `--remote`, una URL de repositorio remoto pasada como argumento posicional, `--stdout`, `--stdin`, `--split-output`, `--skill-generate` o `--copy`. Estas restricciones se aplican tanto si la opción se establece en la línea de comandos como en tu archivo de configuración.

## Recursos relacionados

- [Configuración](/es/guide/configuration) - Establecer opciones en el archivo de configuración en lugar de flags CLI
- [Formatos de salida](/es/guide/output) - Detalles sobre formatos XML, Markdown, JSON y texto plano
- [Compresión de código](/es/guide/code-compress) - Cómo funciona `--compress` con Tree-sitter
- [Seguridad](/es/guide/security) - Qué desactiva `--no-security-check`

## 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

# Repositorio remoto con forma abreviada (detectado automáticamente, sin --remote)
repomix 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

# Modo de observación: volver a empaquetar automáticamente al cambiar los archivos
repomix --watch
repomix -w --include "src/**/*.ts"
```

