Uso Básico

Início Rápido

Compacte todo o seu repositório:

repomix

Casos de Uso Comuns

Compactar Diretórios Específicos

repomix path/to/directory

Incluir Arquivos Específicos

Use glob patterns:

repomix --include "src/**/*.ts,**/*.md"

Excluir Arquivos

repomix --ignore "**/*.log,tmp/"

Repositórios Remotos

# Usando URL do GitHub
repomix --remote https://github.com/user/repo

# Usando abreviação
repomix --remote user/repo

# Branch/tag/commit específico
repomix --remote user/repo --remote-branch main
repomix --remote user/repo --remote-branch 935b695

Entrada de Lista de Arquivos (stdin)

Passe caminhos de arquivos via stdin para máxima flexibilidade:

# Usando comando find
find src -name "*.ts" -type f | repomix --stdin

# Usando git para obter arquivos rastreados
git ls-files "*.ts" | repomix --stdin

# Usando ripgrep (rg) para encontrar arquivos
rg --files --type ts | repomix --stdin

# Usando grep para encontrar arquivos contendo conteúdo específico
grep -l "TODO" **/*.ts | repomix --stdin

# Usando ripgrep para encontrar arquivos com conteúdo específico
rg -l "TODO|FIXME" --type ts | repomix --stdin

# Usando sharkdp/fd para encontrar arquivos
fd -e ts | repomix --stdin

# Usando fzf para selecionar de todos os arquivos
fzf -m | repomix --stdin

# Seleção interativa de arquivos com fzf
find . -name "*.ts" -type f | fzf -m | repomix --stdin

# Usando ls com padrões glob
ls src/**/*.ts | repomix --stdin

# De um arquivo contendo caminhos de arquivos
cat file-list.txt | repomix --stdin

# Entrada direta com echo
echo -e "src/index.ts\nsrc/utils.ts" | repomix --stdin

A opção --stdin permite que você canalize uma lista de caminhos de arquivos para o Repomix, oferecendo máxima flexibilidade na seleção de quais arquivos compactar.

Ao usar --stdin, os arquivos especificados são efetivamente adicionados aos padrões de inclusão. Isso significa que o comportamento normal de inclusão e exclusão ainda se aplica - arquivos especificados via stdin ainda serão excluídos se coincidirem com padrões de exclusão.

NOTE

Ao usar --stdin, os caminhos de arquivos podem ser relativos ou absolutos, e o Repomix tratará automaticamente da resolução de caminhos e deduplicação.

Compressão de Código

repomix --compress

# Você também pode usar com repositórios remotos:
repomix --remote yamadashy/repomix --compress

Integração Git

Incluir informações do Git para fornecer contexto de desenvolvimento para análise de IA:

# Incluir diffs do git (alterações não commitadas)
repomix --include-diffs

# Incluir logs de commits do git (últimos 50 commits por padrão)
repomix --include-logs

# Incluir número específico de commits
repomix --include-logs --include-logs-count 10

# Incluir tanto diffs quanto logs
repomix --include-diffs --include-logs

Isso adiciona contexto valioso sobre:

• Alterações recentes: Diffs do Git mostram modificações não commitadas
• Padrões de desenvolvimento: Logs do Git revelam quais arquivos são tipicamente alterados juntos
• Histórico de commits: Mensagens de commits recentes fornecem insights sobre o foco do desenvolvimento
• Relacionamentos entre arquivos: Entender quais arquivos são modificados nos mesmos commits

Otimização da Contagem de Tokens

Entender a distribuição de tokens da sua base de código é crucial para otimizar as interações com IA. Use a opção --token-count-tree para visualizar o uso de tokens em todo o seu projeto:

repomix --token-count-tree

Isso exibe uma visualização hierárquica da sua base de código com contagens de tokens:

🔢 Token Count Tree:
────────────────────
└── src/ (70,925 tokens)
    ├── cli/ (12,714 tokens)
    │   ├── actions/ (7,546 tokens)
    │   └── reporters/ (990 tokens)
    └── core/ (41,600 tokens)
        ├── file/ (10,098 tokens)
        └── output/ (5,808 tokens)

Você também pode definir um limite mínimo de tokens para focar em arquivos maiores:

repomix --token-count-tree 1000  # Mostrar apenas arquivos/diretórios com 1000+ tokens

Isso ajuda você a:

• Identificar arquivos pesados em tokens - que podem exceder os limites de contexto da IA
• Otimizar a seleção de arquivos - usando padrões --include e --ignore
• Planejar estratégias de compressão - direcionando os maiores contribuidores
• Equilibrar conteúdo vs contexto - ao preparar código para análise de IA

Formatos de Saída

XML (Padrão)

repomix --style xml

Markdown

repomix --style markdown

JSON

repomix --style json

Texto Simples

repomix --style plain

Opções Adicionais

Remover Comentários

repomix --remove-comments

Mostrar Números de Linha

repomix --output-show-line-numbers

Copiar para a Área de Transferência

repomix --copy

Desativar Verificação de Segurança

repomix --no-security-check

Configuração

Inicializar arquivo de configuração:

repomix --init

Veja o Guia de Configuração para opções detalhadas.