O que é Repomix?
O Repomix transforma uma base de código em um único arquivo que você cola em um modelo de chat ou entrega a um agente. Ele percorre o repositório, respeita o .gitignore e escreve todos os arquivos, mais uma árvore de diretórios, em uma saída XML, Markdown, JSON ou texto simples, com contagem de tokens por arquivo e para o repositório inteiro.
Ele roda como CLI (npx, npm, Homebrew ou Docker, Node.js 22 ou mais recente), uma página web em que você cola uma URL do GitHub ou envia um zip, uma extensão do Chrome, uma biblioteca Node.js, uma GitHub Action e um servidor MCP. Kazuki Yamada o mantém sob a licença MIT, financiado por patrocinadores.
Repomix vale a pena?
O Repomix é a forma padrão de transformar um repositório em um único prompt, e seu histórico de segurança em 2026 é o que deve ser lido antes de instalá-lo. O projeto tem cerca de 29,000 estrelas e lançou a v1.18.1 em 21 de setembro de 2026. Essa versão corrigiu um aviso de alta severidade em que empacotar um diretório com uma pasta .git manipulada podia executar helpers do git config; um aviso de maio de 2026 corrigiu injeção de comandos via --remote-branch. Os dois estão corrigidos, mas mostram que apontar um empacotador para repositórios não confiáveis não é um ato neutro.
Fora isso, os recursos defensivos são bem pensados. O Secretlint descarta arquivos que batem com formatos conhecidos de credenciais antes que cheguem à saída. Arquivos de configuração dentro de repositórios remotos são ignorados, a menos que você passe --remote-trust-config. O servidor MCP tem uma flag --sandbox que confina suas ferramentas de arquivos a um diretório, embora um aviso de agosto de 2026 tenha constatado que proteções anteriores do MCP haviam sido anunciadas, mas não implementadas.
A compressão com Tree-sitter é o recurso que muda o que cabe. Ela mantém imports, classes e assinaturas e descarta o corpo das funções, o que, segundo o site, reduz os tokens em cerca de 70%. Padrões por glob permitem manter o código completo dos arquivos sobre os quais você está perguntando e comprimir o resto, um meio-termo melhor do que comprimir tudo.
O teto é a própria abordagem. Mesmo comprimido, um monorepo grande não vai caber, e agentes como Claude Code ou Codex já leem arquivos sob demanda, então um despejo duplica um trabalho que eles fazem melhor. Ferramentas de busca como grepai, ou Sourcegraph na escala de uma empresa, resolvem o caso do repositório grande; o Repomix continua sendo o caminho mais rápido quando quem lê é uma janela de chat, não um agente.
Onde ele se destaca
Um desenvolvedor freelancer que usa Claude ou ChatGPT no navegador
Obter a revisão de um projeto paralelo de 15,000 linhas em uma única conversa
Rodar `npx repomix --compress`, conferir a contagem de tokens contra a janela do modelo e colar o XML. Gratuito, leva menos de um minuto, e o Secretlint impede que um .env perdido vá parar no chat.
Uma equipe de plataforma em uma empresa de 200 engenheiros
Dar a um assistente interno um snapshot noturno do repositório de cada serviço
Uma GitHub Action empacota cada repositório com --split-output em pedaços que o assistente consegue carregar. Sem custo de licença; o risco é o snapshot ficar desatualizado, e repositórios de fora da empresa devem ser empacotados em um sandbox.
Uma gerente de engenharia integrando prestadores de serviço
Entregar uma visão geral da arquitetura sem conceder acesso ao repositório
Empacotar com compressão para que a saída mostre módulos, classes e assinaturas, mas não a implementação, e compartilhar o arquivo. Não custa nada e expõe menos código que um clone completo, embora ainda seja código-fonte.
Antes de decidir
- Configuração
- `npx repomix@latest` em um repositório escreve repomix-output.xml em segundos; exige Node.js 22+. Homebrew, Docker e o site em repomix.com não exigem instalar o Node.
- Integrações
- Saída em XML, Markdown, JSON e texto simples; --remote para qualquer URL, branch ou commit do GitHub; --mcp o roda como servidor MCP; biblioteca Node.js, GitHub Action e extensão do Chrome.
- Dados e privacidade
- A CLI não coleta telemetria e só acessa a rede para --remote e instalações, segundo sua política de privacidade. O site apaga os envios após o processamento e usa Google Analytics. Cinco avisos de segurança no GitHub em 2026, o mais recente corrigido na v1.18.1.
- Custo em escala
- Sem edição paga. O custo real são os tokens de modelo: um repositório empacotado é enviado inteiro a cada prompt, então a compressão e os padrões de include/ignore são o que mantém o gasto baixo.
- Limites
- Sem limite de tamanho fixo, mas a memória e a janela de contexto do modelo o limitam; o site é pensado para repositórios públicos pequenos; o modo watch não pode ser combinado com --remote nem com --split-output.
O que é bom
- A verificação do Secretlint deixa de fora arquivos que parecem credenciais
- Compressão com Tree-sitter, cerca de 70% menos tokens segundo o site
- Configurações de repositórios remotos não são confiáveis por padrão
- CLI, web, extensão, biblioteca, GitHub Action e servidor MCP
O que não é
- Cinco avisos de segurança em 2026, dois classificados como altos
- Despejos do repositório inteiro não escalam para bases de código grandes
- A saída comprimida descarta corpos de funções de que o modelo pode precisar
- Redundante quando seu agente já lê os arquivos sozinho
Ideal para
Desenvolvedores que querem entregar um repositório pequeno ou médio a um modelo de chat em um único arquivo.
Alternativas ao Repomix
Repomix: perguntas frequentes
- Repomix vale a pena?
- O Repomix empacota um repositório pequeno em um único prompt melhor que qualquer outra coisa, e vira a ferramenta errada no momento em que o repositório passa da janela de contexto. Damos nota 4.3 de 5.
- Quanto custa Repomix?
- Gratuito e de código aberto (MIT). A versão web em repomix.com é gratuita; não há nível pago.
- Quais são as desvantagens de Repomix?
- Cinco avisos de segurança em 2026, dois classificados como altos; despejos do repositório inteiro não escalam para bases de código grandes; a saída comprimida descarta corpos de funções de que o modelo pode precisar; redundante quando seu agente já lê os arquivos sozinho.
- Para quem Repomix é indicado?
- Desenvolvedores que querem entregar um repositório pequeno ou médio a um modelo de chat em um único arquivo.
- Quanto custa Repomix para uma equipe ou em produção?
- Sem edição paga. O custo real são os tokens de modelo: um repositório empacotado é enviado inteiro a cada prompt, então a compressão e os padrões de include/ignore são o que mantém o gasto baixo.
- Repomix é seguro para dados da empresa?
- A CLI não coleta telemetria e só acessa a rede para --remote e instalações, segundo sua política de privacidade. O site apaga os envios após o processamento e usa Google Analytics. Cinco avisos de segurança no GitHub em 2026, o mais recente corrigido na v1.18.1.
- Quais são as melhores alternativas ao Repomix?
- As alternativas mais próximas que analisamos são code2prompt e grepai.
Respostas verificadas em 23 de out. de 2026.