Repolode
Enviar
zvec-ai

zvec-ai/zvec-grep

CLI de busca local e ferramenta para agentes que combina ripgrep, BM25 e busca vetorial no seu workspace.

Ver no GitHub
Estrelas
4,264
Forks
261
Issues abertas
90
Último commit
ontem

O que é?

zg (zvec-grep) é uma ferramenta de busca local que pesquisa os arquivos de um workspace. Combina a busca por texto exato e regex do ripgrep, o ranqueamento de palavras-chave com BM25 e a busca semântica vetorial. Assim, uma consulta pode encontrar trechos pelo significado e, quando necessário, verificá-los por meio de texto exato. A ferramenta é baseada no banco de dados vetorial zvec e está disponível como pacote Node.js. O README descreve a implementação em TypeScript/Node.js, e o repositório também inclui uma implementação separada em Rust.

O mesmo índice pode ser usado no terminal pelo CLI zg ou por um agente de IA. O projeto lista integrações com agentes como Codex, Claude Code, Cursor, GitHub Copilot, VS Code e OpenCode, além de incluir um guia de MCP. Ele indexa código-fonte, documentos e dados estruturados, preservando as localizações de origem, e funciona em macOS, Linux e Windows. Por padrão, arquivos, índices e modelos locais de embeddings permanecem na máquina; provedores remotos de embeddings só recebem dados quando essa opção é ativada.

O projeto oferece suporte a modelos locais de embeddings, incluindo Potion/model2vec e os runtimes llama.cpp e Transformers.js, além de opções para controlar a concorrência da indexação e os limites de memória da GPU. Os dados do índice são armazenados em um diretório .zvec-grep/ dentro da raiz indexada.

Recursos principais

  • 01Combina a busca exata e por regex do ripgrep com o ranqueamento de palavras-chave do BM25 e a busca semântica vetorial.
  • 02Funciona no terminal pelo CLI zg ou em agentes de IA por meio de integrações no estilo MCP.
  • 03Indexa código-fonte, documentos e dados estruturados, preservando as localizações de origem.
  • 04Funciona em macOS, Linux e Windows; o pacote npm requer Node.js 22 ou mais recente.
  • 05Por padrão, mantém arquivos, índices e modelos locais na sua máquina.

Casos de uso

  • Encontrar caminhos de código e detalhes da arquitetura em um repositório grande quando não se sabe o nome exato do símbolo.
  • Permitir que um agente de programação com IA pesquise um projeto local e retorne resultados ranqueados com referências às fontes.
  • Pesquisar pelo significado, em vez de por palavras-chave exatas, uma pasta com documentos e código variados.
  • Fazer buscas semânticas privadas sem enviar arquivos para um serviço remoto.

Início rápido

  1. 1

    Instale o zg CLI pelo npm (requer Node.js 22 ou superior).

    npm install -g @zvec/zvec-grep
  2. 2

    Indexe seu workspace com um modelo de embeddings local.

    zg index --embedding local/potion-retrieval-32m
  3. 3

    Faça uma busca pelo terminal.

    zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

Antes de usar

  • Requer Node.js 22 ou superior.
  • O exemplo de agente depende do OpenCode e da disponibilidade de modelos gratuitos, que pode mudar.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFerramentas de CLI e terminalFerramentas de privacidade e local-first

Tópicos

#code-search#semantic-search#full-text-search#vector-search#local-first#cli#ai-agents#mcp#bm25#ripgrep

Perguntas frequentes

O que é zvec-grep?
CLI de busca local e ferramenta para agentes que combina ripgrep, BM25 e busca vetorial no seu workspace. zg (zvec-grep) é uma ferramenta de busca local que pesquisa os arquivos de um workspace. Combina a busca por texto exato e regex do ripgrep, o ranqueamento de palavras-chave com BM25 e a busca semântica vetorial. Assim, uma consulta pode encontrar trechos pelo significado e, quando necessário, verificá-los por meio de texto exato. A ferramenta é baseada no banco de dados vetorial zvec e está disponível como pacote Node.js. O README descreve a implementação em TypeScript/Node.js, e o repositório também inclui uma implementação separada em Rust.
zvec-grep é gratuito? Qual é a licença?
zvec-grep é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
zvec-grep ainda é mantido?
Manutenção ativa. O último commit de zvec-grep foi em 6 de nov. de 2026.
Para que posso usar zvec-grep?
Encontrar caminhos de código e detalhes da arquitetura em um repositório grande quando não se sabe o nome exato do símbolo. Permitir que um agente de programação com IA pesquise um projeto local e retorne resultados ranqueados com referências às fontes. Pesquisar pelo significado, em vez de por palavras-chave exatas, uma pasta com documentos e código variados. Fazer buscas semânticas privadas sem enviar arquivos para um serviço remoto.
Como instalar zvec-grep?
Instale o zg CLI pelo npm (requer Node.js 22 ou superior).: npm install -g @zvec/zvec-grep Indexe seu workspace com um modelo de embeddings local.: zg index --embedding local/potion-retrieval-32m Faça uma busca pelo terminal.: zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3
Onde consigo zvec-grep?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/zvec-ai/zvec-grep

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

Projetos relacionados