Repomix: Converta Todo Seu Repositório em Contexto para Qualquer IA
Você já tentou pedir ao Claude, ChatGPT ou Gemini para ajudar a depurar um bug que envolvia quatro arquivos diferentes — e acabou colando arquivos um por um durante dez minutos antes de a IA conseguir começar a raciocinar sobre o problema.
Esse é exatamente o problema que Repomix resolve: colocar seu repositório completo em um único arquivo limpo, estruturado, pronto para ser consumido por qualquer IA.
Sem copiar e colar. Sem perder conexões entre arquivos. Sem o modelo perder o fio da meada.
O problema que ninguém resolve para você
As ferramentas de IA para código são muito boas dentro de uma janela. São ruins em raciocinar sobre seu projeto completo — não por falta de capacidade, mas por falta de visibilidade.
Cursor vê os arquivos que você tem abertos. Claude.ai vê o que você cola. GitHub Copilot vê o arquivo atual. Nenhum entende automaticamente como seu middleware de autenticação se conecta com suas rotas de API se conecta com seus context providers. Essa imagem você precisa construir para eles.
Repomix constrói para você.
Um único comando
npx repomix
É só isso. Execute no seu diretório de projeto e gere um arquivo repomix-output.xml com todo seu repositório em um formato estruturado e otimizado para LLMs. O arquivo começa com uma explicação orientada ao modelo, depois organiza seu código de forma hierárquica — assim a IA não recebe um despejo de texto, mas uma representação coerente do seu projeto.
Se você vai usar com frequência, instale globalmente:
npm install -g repomix
# ou com Homebrew (macOS/Linux)
brew install repomix
O que o torna realmente útil
Contagem de tokens. Antes de colar nada, Repomix mostra exatamente quantos tokens cada arquivo usa e o total completo. Sem mais adivinhas sobre se seu projeto vai estourar a janela de contexto do Claude.
Respeita seu .gitignore. Exclui automaticamente o que você já disse ao git para ignorar — node_modules, artefatos de build, arquivos de ambiente. Você pode adicionar um .repomixignore para controle adicional.
Segurança integrada. Repomix integra Secretlint para detectar API keys, tokens ou credenciais hardcodeadas antes de terminarem em seu contexto de IA. Importante quando você está prestes a colar um arquivo em uma interface de terceiros.
A flag --compress. Usa Tree-sitter para remover boilerplate de forma inteligente e reduzir a contagem de tokens em aproximadamente 70%, preservando a estrutura que importa. Para repositórios grandes, essa é a diferença entre entrar em contexto ou não.
repomix --compress
Repositórios remotos. Você pode empacotar qualquer repositório público do GitHub sem precisar cloná-lo:
repomix --remote owner/repo
Útil para fazer auditorias de segurança, entender bibliotecas de terceiros, ou passar o código-fonte de uma dependência diretamente para sua IA para uma análise mais profunda.
Fluxos de trabalho práticos
Debugging complexo: Cole o output completo no Claude ou ChatGPT com: “Aqui está todo meu repositório. Meu fluxo de autenticação falha quando os usuários fazem login com Google — rastreie o fluxo e identifique o problema.” A IA agora pode ver cada arquivo, cada dependência, cada conexão.
Refatoração: “Revise este projeto e proponha um plano de migração de REST para tRPC.” Tem o contexto para dar uma resposta real, não genérica.
Geração de documentação: Passe seu projeto completo e peça um README atualizado, documentação de API, ou um overview de arquitetura.
Code review antes de um PR: Execute Repomix, cole em seu LLM favorito, peça uma revisão abrangente. Cada arquivo é revisado em conjunto, não isoladamente.
O servidor MCP
Para uma experiência mais integrada, Repomix também funciona como servidor MCP — o que significa que você pode usá-lo diretamente dentro do Claude Code, Claude Desktop, ou qualquer cliente compatível com MCP:
npx repomix --mcp
Isso permite que seu assistente de IA consulte seu repositório através do Repomix de forma interativa, em vez de receber um arquivo estático. Mais dinâmico, e útil para sessões longas onde o código muda enquanto você trabalha.
Por que importa ser agnóstico de modelo
Vale a pena dizer explicitamente: Repomix não se importa qual IA você está usando. O output funciona com Claude, ChatGPT, Gemini, DeepSeek, Perplexity, Grok, Llama, ou qualquer modelo local que você esteja rodando através do LM Studio ou Ollama.
Também significa que você pode comparar como diferentes modelos lidam com o mesmo repositório. Execute o mesmo prompt contra Claude e Gemini e veja qual dá melhor conselho arquitetônico para seu stack específico.
Repomix foi indicado na categoria “Powered by AI” dos JSNation Open Source Awards 2025 — um reconhecimento que reflete bem a tração que ganhou na comunidade.
Links
- Website: repomix.com
- GitHub: yamadashy/repomix
- Docs: repomix.com/guide