Repolode
Enviar
yoanbernabeu

yoanbernabeu/grepai

CLI com foco em privacidade para busca semântica de código, com embeddings locais, rastreamento do grafo de chamadas e um servidor MCP para agentes de programação com IA.

Ver no GitHubSite
Estrelas
1,940
Forks
160
Issues abertas
81
Último commit
há 6 dias

O que é?

grepai é uma ferramenta de linha de comando para pesquisar bases de código pelo significado, em vez de buscar apenas textos exatos. Ela cria um índice vetorial do seu código usando embeddings, permitindo que uma consulta em linguagem natural, como "fluxo de autenticação de usuário", encontre funções relevantes mesmo quando elas têm outros nomes.

A ferramenta roda inteiramente na sua máquina e funciona com um provedor local de embeddings, como Ollama. Também há suporte para LM Studio e OpenAI. Um observador de arquivos em segundo plano mantém o índice atualizado conforme os arquivos mudam. Ela também inclui rastreamento do grafo de chamadas, para você ver quais funções chamam uma determinada função antes de modificá-la.

grepai se disponibiliza como servidor MCP, permitindo que agentes de IA, como Claude Code, Cursor e Windsurf, o chamem como uma ferramenta. Segundo o projeto, isso reduz os tokens de entrada que os agentes gastam lendo código, pois eles recebem contexto direcionado em vez dos resultados brutos da busca.

Recursos principais

  • 01Busca semântica que encontra código pela intenção, não por texto exato
  • 02Rastreamento do grafo de chamadas para encontrar funções que chamam uma função
  • 03Execução totalmente local com embeddings do Ollama, LM Studio ou OpenAI
  • 04Observador de arquivos que mantém o índice atualizado automaticamente
  • 05Servidor MCP para agentes de IA chamarem o grepai

Casos de uso

  • Permitir que Claude Code ou Cursor encontrem código relevante sem ler arquivos inteiros
  • Localizar código por conceito quando você não sabe o nome exato da função
  • Verificar quais funções chamam uma função antes de refatorá-la
  • Pesquisar uma base de código privada sem enviar código para serviços externos

Início rápido

  1. 1

    Instale via Homebrew (macOS)

    brew install yoanbernabeu/tap/grepai
  2. 2

    Instale um provedor de embeddings: use pull para baixar o modelo nomic-embed-text do Ollama

    ollama pull nomic-embed-text
  3. 3

    Inicialize o grepai no projeto e, em seguida, inicie o daemon de indexação

    grepai init && grepai watch
  4. 4

    Pesquise seu código por significado

    grepai search "error handling"

Antes de usar

  • É necessário um provedor de embeddings separado, como Ollama, LM Studio ou OpenAI.
  • No README, a instalação no Linux e no Windows usa um script de instalação via curl ou PowerShell, em vez de um gerenciador de pacotes.

Em coleções

Servidores MCP para Claude CodeFerramentas, skills e plugins para Claude CodeAssistentes e agentes de programação com IAServidores MCPFerramentas de CLI e terminal

Tópicos

#code-search#semantic-search#embeddings#mcp#cli#vector-search#developer-tools#ai#claude-code#cursor

Perguntas frequentes

O que é grepai?
CLI com foco em privacidade para busca semântica de código, com embeddings locais, rastreamento do grafo de chamadas e um servidor MCP para agentes de programação com IA. grepai é uma ferramenta de linha de comando para pesquisar bases de código pelo significado, em vez de buscar apenas textos exatos. Ela cria um índice vetorial do seu código usando embeddings, permitindo que uma consulta em linguagem natural, como "fluxo de autenticação de usuário", encontre funções relevantes mesmo quando elas têm outros nomes.
grepai é gratuito? Qual é a licença?
grepai é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
grepai ainda é mantido?
Manutenção ativa. O último commit de grepai foi em 2 de nov. de 2026.
Para que posso usar grepai?
Permitir que Claude Code ou Cursor encontrem código relevante sem ler arquivos inteiros Localizar código por conceito quando você não sabe o nome exato da função Verificar quais funções chamam uma função antes de refatorá-la Pesquisar uma base de código privada sem enviar código para serviços externos
Como instalar grepai?
Instale via Homebrew (macOS): brew install yoanbernabeu/tap/grepai Instale um provedor de embeddings: use pull para baixar o modelo nomic-embed-text do Ollama: ollama pull nomic-embed-text Inicialize o grepai no projeto e, em seguida, inicie o daemon de indexação: grepai init && grepai watch Pesquise seu código por significado: grepai search "error handling"
Onde consigo grepai?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yoanbernabeu/grepai

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados