Skip to content

Opções de Linha de Comando

Opções Básicas

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

Opções de Entrada/Saída CLI

  • --verbose: Habilitar registro detalhado
  • --quiet: Desabilitar toda saída para stdout
  • --stdout: Saída para stdout em vez de escrever para um arquivo (não pode ser usado com a opção --output)
  • --stdin: Ler caminhos de arquivos do stdin em vez de descobrir arquivos automaticamente
  • --copy: Copiar adicionalmente a saída gerada para a área de transferência do sistema
  • --token-count-tree [threshold]: Exibir árvore de arquivos com resumos de contagem de tokens (opcional: limite mínimo de contagem de tokens). Útil para identificar arquivos grandes e otimizar o uso de tokens para limites de contexto de IA
  • --top-files-len <number>: Número dos maiores arquivos para exibir no resumo (padrão: 5, ex: --top-files-len 20)

Opções de Saída do Repomix

  • -o, --output <file>: Caminho do arquivo de saída (padrão: repomix-output.xml, usar "-" para stdout)
  • --style <type>: Formato de saída: xml, markdown, json ou plain (padrão: xml)
  • --parsable-style: Habilitar saída analisável baseada no esquema de estilo escolhido. Note que isso pode aumentar a contagem de tokens.
  • --compress: Realizar extração inteligente de código, focando em assinaturas essenciais de funções e classes para reduzir a contagem de tokens
  • --output-show-line-numbers: Mostrar números de linha na saída
  • --no-file-summary: Desabilitar saída da seção de resumo de arquivos
  • --no-directory-structure: Desabilitar saída da seção de estrutura de diretórios
  • --no-files: Desabilitar saída de conteúdo de arquivos (modo somente metadados)
  • --remove-comments: Remover comentários de tipos de arquivos suportados
  • --remove-empty-lines: Remover linhas vazias da saída
  • --truncate-base64: Habilitar truncamento de strings de dados base64
  • --header-text <text>: Texto personalizado para incluir no cabeçalho do arquivo
  • --instruction-file-path <path>: Caminho para um arquivo contendo instruções personalizadas detalhadas
  • --include-empty-directories: Incluir diretórios vazios na saída
  • --include-full-directory-structure: Mostrar a árvore completa do repositório na seção Estrutura de Diretórios, mesmo ao usar padrões --include
  • --include-diffs: Incluir diffs do git na saída (inclui mudanças da árvore de trabalho e mudanças em stage separadamente)
  • --include-logs: Incluir logs do git na saída (inclui histórico de commits com datas, mensagens e caminhos de arquivos)
  • --include-logs-count <count>: Número de commits do log do git para incluir (padrão: 50)
  • --no-git-sort-by-changes: Desabilitar ordenação de arquivos por contagem de mudanças do git (habilitado por padrão)

Opções de Seleção de Arquivos

  • --include <patterns>: Lista de padrões de inclusão (separados por vírgula)
  • -i, --ignore <patterns>: Padrões de ignorar adicionais (separados por vírgula)
  • --no-gitignore: Desabilitar uso do arquivo .gitignore
  • --no-default-patterns: Desabilitar padrões padrão

Opções de Repositório Remoto

  • --remote <url>: Processar repositório remoto
  • --remote-branch <name>: Especificar nome do branch remoto, tag ou hash do commit (padrão para o branch padrão do repositório)

Opções de Configuração

  • -c, --config <path>: Caminho do arquivo de configuração personalizado
  • --init: Criar arquivo de configuração
  • --global: Usar configuração global

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

Exemplos

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

Released under the MIT License.