// devtools · zvec-ai/zvec-grep

zvec-grep

zvec-grep é um projeto de ferramentas de desenvolvimento de código aberto de zvec-ai (zvec-ai/zvec-grep no GitHub). Tem 3.994 estrelas no GitHub e 235 forks, é publicado sob a licença Apache-2.0 e foi atualizado pela última vez no GitHub em 8 de outubro de 2026.

zvec-grep (zg): one local CLI unifying ripgrep-style exact search, BM25, and semantic vector search

★ 4,0 mil estrelas⑂ 235 forksApache-2.0atualizado out 2026
▦ visual: o README deste projeto não inclui nenhuma captura incorporável,
então aqui vai um marcador. O guia abaixo está completo mesmo assim.
// dados do projeto

Dados do projeto

Repositório
zvec-ai/zvec-grep
Estrelas no GitHub
3.994
Forks
235
Licença
Apache-2.0
Última atualização no GitHub
8 de outubro de 2026
Tipo de ficha
Guia de instalação completo
// como funciona

Como funciona

  1. Pick your corpus

    Choose the codebase or document set you want searchable by meaning, not just by string.

  2. Install zg

    Install the CLI globally from npm (Node.js 22+).

  3. Build the index

    Run zg index with a local embedding model to create the .zvec-grep/ index.

  4. Ask in natural language

    Query with --human for readable, cited results, or wire zg into your agent via its installer/MCP tools.

// recursos

Por que as pessoas gostam tanto

Three search modes in one tool

Exact (ripgrep-style), BM25, and vector/semantic search behind a single interface.

Code, docs, and data

Symbol-aware code search plus document and structured-data search.

Cited results

Ranked answers link back to source files and lines.

Local-first indexing

Indexes live in .zvec-grep/; local embedding models keep data on your machine by default.

Agent integration

One-command installs into agent tools (for example OpenCode) and MCP tool exposure.

Fast repeat queries

Index once, then query repeatedly without re-embedding the corpus.

Advertisement
// execute você mesmo

Execute você mesmo

  1. Clone the repository

    Clone the project and enter its directory (CLI users can install from npm instead).

    git clone https://github.com/zvec-ai/zvec-grep.git
    cd zvec-grep
  2. Install the CLI

    Install zg globally from npm (Node.js 22+ required).

    npm install -g @zvec/zvec-grep
  3. Index and query

    Build an index with a local embedding model, then ask a question.

    zg index --embedding local/potion-retrieval-32m
    zg query --human "where is authentication handled?" --limit 3
// casos de uso

O que você pode criar

Advertisement
// perguntas frequentes

Perguntas frequentes

Who maintains zvec-grep?

zvec-ai develops zvec-grep (the zvec vector-search project team).

Is zvec-grep free?

Yes, Apache-2.0 licensed and local-first.

Does it need a paid API key?

No — local embedding models are supported and are the default posture; remote embeddings are used only with your permission.

How does it compare to ripgrep alone?

ripgrep finds exact strings. zg keeps that, adds BM25 ranking and semantic vector search, and returns ranked results with citations — at the cost of building an index first.

How do I get started?

Run `npm install -g @zvec/zvec-grep`, `zg index` in your project, then `zg query --human "your question"`.

// continue explorando

Ferramentas semelhantes

Ferramentas de desenvolvimento

probe

Semantic code search for AI — ripgrep speed with tree-sitter AST parsing.

★ 722 estrelasApache-2.0
Ver o guia →
Ferramentas de desenvolvimento

semble

Fast, accurate semantic code search for agents — about 99% fewer tokens than grep plus read.

★ 6,2 mil estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

cocoindex-code

Lightweight AST-based semantic code search CLI (ccc) that makes coding agents faster and cheaper

★ 2,8 mil estrelasApache-2.0
Ver o guia →
Ferramentas de desenvolvimento

treg

An OpenRouter-style registry for agent tools: one token, thousands of priced endpoints, your own keys too

★ 4,8 mil estrelasNOASSERTION
Ver o guia →
Ferramentas de desenvolvimento

ygrep

Fast, local, indexed code search built for AI assistants.

★ 60 estrelasMIT
Ver o guia →
Ferramentas de desenvolvimento

rtk

CLI proxy that cuts LLM token consumption 60-90% on common dev commands — one Rust binary

★ 82,7 mil estrelasApache-2.0
Ver o guia →
// alternativas

Alternativas em Ferramentas de desenvolvimento

Os outros projetos de Ferramentas de desenvolvimento com mais estrelas no catálogo do LibreAI — a lista realista de alternativas se zvec-grep não for o ideal para você.

// mais em devtools

Mais em Ferramentas de desenvolvimento

Projetos de Ferramentas de desenvolvimento próximos no catálogo, os mais próximos em estrelas de zvec-grep: continue explorando dos dois lados dele.

Baixe o zvec-grep

Grátis e aberto: pegue o código-fonte, dê uma estrela no repositório e comece a criar.