grepai
Yoan Bernabeu · Programação
O grepai é uma ferramenta de linha de comando que prioriza a privacidade e busca na sua base de código por significado em vez de texto exato. Ele monta um índice local do seu código com embeddings vetoriais, então você digita "fluxo de autenticação de usuário" e cai na função que cuida disso, mesmo que ela tenha outro nome. No caminho, ele rastreia quem chama e quem é chamado, mantém o índice atualizado com um monitor de arquivos e se conecta a assistentes de código com IA como Claude Code e Cursor por meio de um servidor MCP. Tudo roda na sua máquina. Nada é enviado para lugar nenhum.
Sobre grepai
O que é o grepai
O grepai é uma CLI de código aberto para busca semântica de código, criada pelo desenvolvedor Yoan Bernabeu e publicada sob licença MIT. O nome é uma referência ao grep original de 1973, mas a ideia é outra. O grep clássico combina padrões de texto. O grepai converte suas funções e classes em vetores e combina significado, então uma busca por "tratamento de erros" pode revelar uma função chamada catchException que você nunca teria pensado em digitar.
A ferramenta foi feita para dois públicos. Desenvolvedores cansados de adivinhar nomes de símbolos em repositórios grandes são o primeiro. O segundo são os agentes de IA de programação, que gastam muitos tokens fazendo grep e relendo arquivos antes de entender qualquer coisa. Ao entregar a um agente uma lista curta de código relevante em vez da saída bruta de uma busca, o grepai corta os tokens de entrada que esses agentes precisam. Usuários do r/ClaudeAI relataram exatamente isso. Um desenvolvedor disse que seus tokens de entrada no Claude Code caíram bastante.
A principal limitação é a configuração. O grepai precisa de um provedor de embeddings para transformar código em vetores, o que significa instalar o Ollama e baixar um modelo, ou entregar uma chave de API de um provedor na nuvem. Não é um comando que você roda e esquece. Em uma máquina modesta, o primeiro índice de um repositório grande também demora. Para quem vive no terminal, é uma troca justa. Para todo o resto, provavelmente é mais maquinário do que se quer.
Primeiros passos
- Instale o grepai com o script de uma linha para o seu sistema, ou use o Homebrew no macOS. No Windows, pegue o comando do PowerShell na página do GitHub.
- Baixe um modelo de embeddings para o Ollama, normalmente
nomic-embed-text, já que embeddings locais mantêm seu código na sua máquina. - Rode
grepai initdentro do seu projeto para criar a configuração e montar o índice. - Inicie
grepai watchpara que o monitor de arquivos mantenha o índice atualizado enquanto você edita. - Busque em inglês simples com
grepai search "error handling", ou rastreie relações comgrepai trace callers "Login".
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de grepai.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Desenvolvedores em bases de código grandes ou desconhecidas
- Usuários de agentes de IA de programação
- Equipes atentas à privacidade
Tarefas
- Explorar uma base de código herdada
- Refatoração segura
- Dar contexto a um assistente de IA
Cenários
- Entrar em um projeto novo e precisar entender um recurso rápido
- Trabalhar offline
- Sessões longas de programação em que os tokens se acumulam
Principais recursos
Busca semântica em linguagem natural
Em vez de combinar padrões de texto, o grepai converte o código em embeddings e busca por significado. Você descreve o que procura, como "onde validamos a entrada", e ele devolve código que você não encontraria com uma palavra-chave. E por que isso importa? Porque bases de código reais nunca nomeiam as coisas como você espera. É o motivo central para usá-lo em vez do ripgrep, e ele funciona entre convenções de nomes que não batem.
Rastreamento de grafo de chamadas
O comando grepai trace mostra quem chama uma função e o que essa função chama por sua vez. Antes de uma refatoração, isso diz o raio de impacto de uma mudança. Cobre uma lista longa de linguagens: Go, TypeScript, JavaScript, Python, PHP, Java, C#, F#, C, C++, Rust e Zig.
100% local e privado
Como ferramenta local de busca de código, o grepai mantém a indexação, os embeddings e a busca na sua máquina quando você o aponta para um modelo do Ollama. Sem nuvem. Sem chamadas de API. Sem código saindo do seu notebook. Para equipes com código sensível, isso remove a objeção de sempre à busca assistida por IA.
Servidor MCP para agentes de IA
O grepai traz um servidor MCP para código, além de um modo de saída JSON, então ferramentas de IA podem chamá-lo direto. Claude Code, Cursor, Windsurf, Codex CLI e Gemini CLI se integram a ele. Isso deixa os agentes pegarem contexto de código focado em vez de rolar resultados brutos do grep, e é o recurso que mais economiza tokens em uma sessão longa.
Atualizações do índice em tempo real
Um monitor de arquivos mantém o índice fresco enquanto você trabalha, então você não reindexa na mão depois de cada mudança. Os resultados de busca refletem suas últimas edições, o que importa quando você itera rápido.
Binário único, instalação rápida
O grepai instala como um único binário sem dependências. Pelos números do próprio projeto, ele indexa 10 mil arquivos em segundos e devolve buscas em milissegundos. Isso o mantém utilizável em repositórios grandes.
Prós e contras
Prós
- Encontra código por significado, então nomes que não batem deixam de ser um obstáculo.
- Roda inteiramente local com o Ollama, mantendo o código-fonte fora de qualquer servidor.
- Integra-se com Claude Code, Cursor e outros agentes via MCP, cortando o uso de tokens.
- Grátis e de código aberto sob MIT, com instalação de uma linha e binário único.
Contras
- Precisa de um provedor de embeddings, então a configuração significa instalar o Ollama ou compartilhar uma chave de API na nuvem.
- A primeira indexação de um repositório grande demora um pouco em hardware modesto.
- O rastreamento de grafo de chamadas depende do suporte das linguagens, então algumas não estão cobertas.
Perguntas frequentes
Ele indexa seu código por significado e deixa você buscá-lo em linguagem natural, então você encontra funções relevantes mesmo sem saber seus nomes. Também rastreia relações de chamada e pode entregar resultados a agentes de IA de programação.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a grepai.
Alternativas a grepai
Base Code
Base44 (Wix) · Programação · ProdutividadeO Base Code é um ambiente de desenvolvimento em nuvem compartilhado da Base44. O time descreve mudanças em um repositório do GitHub pelo chat, confere tudo na prévia e envia o resultado como pull request.
Google EmbeddingGemma 2
Google DeepMind · Escrita · Imagem · ProgramaçãoGoogle EmbeddingGemma 2 é um modelo aberto de 740 milhões de parâmetros que transforma texto, código, imagens, áudio e quadros de vídeo em vetores de um único espaço de 768 dimensões, rodando em celulares e notebooks.
GitGlow
GitGlow · Programação · ProdutividadeO GitGlow é um cliente Git de desktop que coloca seu código e as mudanças dos seus agentes de IA na mesma revisão, para você saber o que vai sair da máquina antes de publicar.