Opções de Linha de Comando

Opções Básicas

• -v, --version: Mostrar versão da ferramenta

Opções de Entrada/Saída CLI

Opção	Descrição
--verbose	Habilitar registro detalhado de depuração (mostra processamento de arquivos, contagem de tokens e detalhes de configuração)
--quiet	Suprimir toda saída do console exceto erros (útil para scripting)
--stdout	Escrever saída empacotada diretamente para stdout em vez de um arquivo (suprime todo o registro)
--stdin	Ler caminhos de arquivos do stdin, um por linha (os arquivos especificados são processados diretamente)
--copy	Copiar a saída gerada para a área de transferência do sistema após o processamento
--token-count-tree [threshold]	Exibir árvore de arquivos com contagem de tokens; limite opcional para mostrar apenas arquivos com ≥N tokens (ex: --token-count-tree 100)
--top-files-len <number>	Número dos maiores arquivos para exibir no resumo (padrão: 5)

Opções de Saída do Repomix

Opção	Descrição
-o, --output <file>	Caminho do arquivo de saída (padrão: repomix-output.xml, usar "-" para stdout)
--style <style>	Formato de saída: xml, markdown, json ou plain (padrão: xml)
--parsable-style	Escapar caracteres especiais para garantir XML/Markdown válido (necessário quando a saída contém código que quebra a formatação)
--compress	Extrair a estrutura essencial do código (classes, funções, interfaces) usando análise Tree-sitter
--output-show-line-numbers	Adicionar número de linha a cada linha na saída
--no-file-summary	Omitir a seção de resumo de arquivos da saída
--no-directory-structure	Omitir a visualização da árvore de diretórios da saída
--no-files	Gerar apenas metadados sem conteúdo de arquivos (útil para análise de repositório)
--remove-comments	Remover todos os comentários do código antes de empacotar
--remove-empty-lines	Remover linhas em branco de todos os arquivos
--truncate-base64	Truncar strings longas de dados base64 para reduzir o tamanho da saída
--header-text <text>	Texto personalizado para incluir no início da saída
--instruction-file-path <path>	Caminho para um arquivo contendo instruções personalizadas para incluir na saída
--split-output <size>	Dividir saída em múltiplos arquivos numerados (ex: repomix-output.1.xml); tamanho como 500kb, 2mb ou 1.5mb
--include-empty-directories	Incluir pastas sem arquivos na estrutura de diretórios
--include-full-directory-structure	Mostrar a árvore completa do repositório na seção Estrutura de Diretórios, mesmo ao usar padrões --include
--no-git-sort-by-changes	Não ordenar arquivos por frequência de mudanças no git (padrão: arquivos mais modificados primeiro)
--include-diffs	Adicionar seção de git diff mostrando mudanças da árvore de trabalho e mudanças em stage
--include-logs	Adicionar histórico de commits do git com mensagens e arquivos modificados
--include-logs-count <count>	Número de commits recentes para incluir com --include-logs (padrão: 50)

Opções de Seleção de Arquivos

Opção	Descrição
--include <patterns>	Incluir apenas arquivos correspondentes a estes padrões glob (separados por vírgula, ex: "src/**/*.js,*.md")
-i, --ignore <patterns>	Padrões adicionais para excluir (separados por vírgula, ex: "*.test.js,docs/**")
--no-gitignore	Não usar regras .gitignore para filtrar arquivos
--no-dot-ignore	Não usar regras .ignore para filtrar arquivos
--no-default-patterns	Não aplicar padrões de exclusão integrados (node_modules, .git, diretórios de build, etc.)

Opções de Repositório Remoto

Opção	Descrição
--remote <url>	Clonar e empacotar um repositório remoto (URL do GitHub ou formato user/repo)
--remote-branch <name>	Branch, tag ou commit específico a usar (padrão: branch padrão do repositório)
--remote-trust-config	Confiar e carregar arquivos de configuração de repositórios remotos (desabilitado por padrão por segurança)

Opções de Configuração

Opção	Descrição
-c, --config <path>	Usar arquivo de configuração personalizado em vez de repomix.config.json
--init	Criar um novo arquivo repomix.config.json com valores padrão
--global	Com --init, criar configuração no diretório home em vez do diretório atual

Opções de Segurança

• --no-security-check: Pular verificação de dados sensíveis como chaves de API e senhas

Opções de Contagem de Tokens

• --token-count-encoding <encoding>: Modelo tokenizador para contagem: o200k_base (GPT-4o), cl100k_base (GPT-3.5/4), etc. (padrão: o200k_base)

Opções MCP

• --mcp: Executar como servidor Model Context Protocol para integração de ferramentas de IA

Opções de Geração de Agent Skills

Opção	Descrição
--skill-generate [name]	Gerar saída no formato Claude Agent Skills no diretório .claude/skills/<name>/ (nome gerado automaticamente se omitido)
--skill-output <path>	Especificar o caminho do diretório de saída de skills diretamente (pula o prompt de local)
-f, --force	Pular todos os prompts de confirmação (ex: sobrescrita do diretório de skills)

Recursos relacionados

• Configuração - Definir opções no arquivo de configuração em vez de flags CLI
• Formatos de Saída - Detalhes sobre formatos XML, Markdown, JSON e texto simples
• Compressão de Código - Como --compress funciona com Tree-sitter
• Segurança - O que --no-security-check desativa

Exemplos

# Uso básico
repomix

# Arquivo de saída e formato personalizados
repomix -o my-output.xml --style xml

# Saída para stdout
repomix --stdout > custom-output.txt

# Saída para stdout, depois pipe para outro comando (ex., simonw/llm)
repomix --stdout | llm "Por favor explique o que este código faz."

# Saída personalizada com compressão
repomix --compress

# Processar arquivos específicos com padrões
repomix --include "src/**/*.ts,*.md" --ignore "*.test.js,docs/**"

# Repositório remoto com branch
repomix --remote https://github.com/user/repo/tree/main

# Repositório remoto com commit
repomix --remote https://github.com/user/repo/commit/836abcd7335137228ad77feb28655d85712680f1

# Repositório remoto com forma abreviada
repomix --remote user/repo

# Lista de arquivos 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

# Integração Git
repomix --include-diffs  # Incluir diffs do git para mudanças não commitadas
repomix --include-logs   # Incluir logs do git (últimos 50 commits por padrão)
repomix --include-logs --include-logs-count 10  # Incluir últimos 10 commits
repomix --include-diffs --include-logs  # Incluir tanto diffs quanto logs

# Análise de contagem de tokens
repomix --token-count-tree
repomix --token-count-tree 1000  # Mostrar apenas arquivos/diretórios com 1000+ tokens