O que é grepai?
O grepai é uma ferramenta de linha de comando que permite a você, ou a um agente de programação, buscar código pelo significado em vez do texto exato. Ele transforma o seu código em embeddings vetoriais (representações numéricas do significado), de modo que uma consulta como "authentication logic" pode encontrar uma função chamada handleUserSession. Ele também rastreia grafos de chamadas: quais funções chamam uma determinada função e quais ela chama.
É distribuído como um único binário em Go sob a licença MIT, feito por Yoan Bernabeu. Os embeddings vêm do Ollama por padrão, ou do LM Studio ou da OpenAI, então ele pode rodar totalmente offline. O índice fica por padrão em um arquivo local, ou no PostgreSQL com pgvector ou no Qdrant. Um observador de arquivos o mantém atualizado, e o grepai mcp-serve o expõe ao Claude Code, ao Cursor, ao Windsurf e a outros clientes MCP.
grepai vale a pena?
O grepai é uma resposta local sensata para agentes de programação que queimam tokens em ciclos de grep e leitura, e seu único benchmark publicado é mais modesto que o destaque. O mantenedor rodou o Claude Code no Excalidraw, mais de 155.000 linhas de TypeScript, com e sem o grepai, fazendo cinco perguntas. Os tokens de entrada novos caíram 97%, mas as leituras de cache subiram 30%, então o custo total aos preços do Opus 4.5 foi de US$ 6,78 para US$ 4,92, uma economia de 27,5%. As chamadas de ferramenta caíram de 139 para 62. O post admite que não mediu a qualidade das respostas, o tempo de execução nem nenhuma outra base de código.
A lista de recursos é ampla para um projeto de uma pessoa só: busca semântica, rastreamento de quem chama e de quem é chamado, referências de leitura e escrita, workspaces com vários projetos, suporte a git worktree e 27 skills para agentes. A documentação lista suporte a grafo de chamadas para 12 linguagens, de Go e TypeScript a Rust e Zig. Os backends PostgreSQL e Qdrant importam mais do que parece, porque transformam um índice por notebook em um que a equipe pode compartilhar.
Ele ainda é jovem. A versão mais recente, v0.37.0, saiu em 10 de setembro de 2026 e nada foi commitado desde então; o projeto tem cerca de 1.900 estrelas e 81 issues abertas. A instalação documentada é um script curl para o shell ou o Homebrew, e a qualidade da busca depende do modelo de embeddings que você rodar, nomic-embed-text por padrão. Escolher os embeddings da OpenAI pela velocidade significa enviar trechos de código para a OpenAI, o que desfaz o argumento de privacidade.
O Sourcegraph dá respostas exatas e exaustivas em milhares de repositórios; o grepai dá respostas aproximadas em alguns poucos. Para um agente que só precisa de um ponto de partida antes de abrir arquivos, o aproximado costuma bastar, e a economia aparece na linha de criação de cache da conta, e não no número de entrada em destaque.
Onde ele se destaca
Um desenvolvedor trabalhando em um app TypeScript de 150.000 linhas com o Claude Code no Opus
Reduzir o custo das perguntas do tipo "onde esse comportamento é tratado?"
Rode grepai watch e registre grepai mcp-serve; o agente busca antes de ler arquivos. O benchmark do mantenedor, em um repositório desse tamanho, mediu custo por sessão 27,5% menor, com os embeddings do Ollama sem custo.
Um prestador de serviço trabalhando em código sob NDA
Buscar na base de código de um cliente pelo significado sem enviá-la a terceiros
Use o Ollama com nomic-embed-text e o arquivo de índice local padrão. Nada sai do notebook; trocar para os embeddings da OpenAI enviaria código para a OpenAI.
Uma equipe de plataforma de 20 engenheiros em um único monorepo
Compartilhar um único índice semântico em vez de cada notebook construir o seu
Aponte o armazenamento para o PostgreSQL com pgvector ou para um cluster Qdrant. O software é gratuito; o custo é operar o banco de dados, e a documentação não descreve controles de acesso além dos do próprio banco.
Antes de decidir
- Configuração
- Homebrew ou o script de instalação, `ollama pull nomic-embed-text`, depois `grepai init` e `grepai watch` no projeto; as primeiras buscas funcionam assim que o índice inicial é construído.
- Integrações
- Servidor MCP via `grepai mcp-serve` para Claude Code, Cursor, Windsurf e outros clientes; embedders Ollama, LM Studio e OpenAI (text-embedding-3-small); armazenamento em um arquivo GOB local, PostgreSQL com pgvector ou Qdrant, incluindo o Qdrant Cloud.
- Dados e privacidade
- Com Ollama ou LM Studio, código e embeddings ficam locais; os embeddings da OpenAI enviam trechos de código para a OpenAI. A entrada do changelog da 0.2.0 lista "No telemetry or data collection" em Security, e a documentação não diz mais nada. Licença MIT.
- Custo em escala
- Sem edição paga. Os custos são a computação local dos embeddings, ou as tarifas por token da OpenAI, mais um banco de dados se o índice for compartilhado; no benchmark, cinco perguntas custaram US$ 4,92 em vez de US$ 6,78 aos preços do Opus 4.5.
- Limites
- Anterior à 1.0 e sem versão desde 10 de setembro de 2026; 81 issues abertas; a evidência de economia de tokens é um único benchmark rodado pelo mantenedor, sem medida de qualidade.
O que é bom
- Roda totalmente local com Ollama; o código fica na máquina
- Rastreamento de grafo de chamadas para 12 linguagens, segundo a documentação
- Servidor MCP e observador de arquivos embutidos
- Backends PostgreSQL e Qdrant para um índice compartilhado
O que não é
- Ainda na v0.x; nenhuma versão desde setembro de 2026
- O único benchmark foi rodado pelo mantenedor, em um repositório, com cinco perguntas
- Os resultados dependem do modelo de embeddings que você roda
- Busca por similaridade, não exata nem exaustiva
Ideal para
Desenvolvedores que querem que o agente de programação busque em um repositório pelo significado, localmente, em vez de ler arquivos inteiros.
Alternativas ao grepai
grepai: perguntas frequentes
- grepai vale a pena?
- O grepai reduz a conta de leitura de código de um agente sem enviar código a lugar nenhum, embora o próprio benchmark coloque a economia mais perto de um quarto do que dos 97% do destaque. Damos nota 3.7 de 5.
- Quanto custa grepai?
- Gratuito e open source (MIT). Roda localmente com Ollama ou LM Studio; os embeddings da OpenAI são cobrados pela OpenAI.
- Quais são as desvantagens de grepai?
- Ainda na v0.x; nenhuma versão desde setembro de 2026; o único benchmark foi rodado pelo mantenedor, em um repositório, com cinco perguntas; os resultados dependem do modelo de embeddings que você roda; busca por similaridade, não exata nem exaustiva.
- Para quem grepai é indicado?
- Desenvolvedores que querem que o agente de programação busque em um repositório pelo significado, localmente, em vez de ler arquivos inteiros.
- Quanto custa grepai para uma equipe ou em produção?
- Sem edição paga. Os custos são a computação local dos embeddings, ou as tarifas por token da OpenAI, mais um banco de dados se o índice for compartilhado; no benchmark, cinco perguntas custaram US$ 4,92 em vez de US$ 6,78 aos preços do Opus 4.5.
- grepai é seguro para dados da empresa?
- Com Ollama ou LM Studio, código e embeddings ficam locais; os embeddings da OpenAI enviam trechos de código para a OpenAI. A entrada do changelog da 0.2.0 lista "No telemetry or data collection" em Security, e a documentação não diz mais nada. Licença MIT.
- Quais são as melhores alternativas ao grepai?
- As alternativas mais próximas que analisamos são Repomix e code2prompt.
Respostas verificadas em 26 de out. de 2026.