zvec-grep (zg): A Local-First Hybrid Search Engine for Humans and AI Agents

Zvec-ai released zvec-grep (zg), an open-source, local-first hybrid search engine that unifies ripgrep-style regex matching, BM25, and local vector search in a single command-line tool. Built on Alibaba's zvec vector library, zg indexes source code, documents, and configuration files locally under a .zvec-grep/ directory, keeping embeddings and indexes on the developer's machine rather than sending code to cloud APIs. The tool is designed for both human developers and AI coding agents such as Claude Code, Codex, and OpenCode, returning ranked, source-linked snippets to reduce token consumption during repository exploration.

For years, ripgrep has been the undisputed champion of developer code search—offering instant, multi-threaded regex matching across massive directory trees. Yet traditional grep tools share a fundamental limitation: they require the user to anticipate the exact string literal, variable name, or regex pattern. When developers or AI coding agents navigate unfamiliar codebases, architectural intent is often conceptual "where is database connection pooling configured?" or "how are expired user sessions cleaned up?" . In those scenarios, keyword search requires tedious guessing loops. zvec-grep zg is an open-source search engine developed by zvec-ai. Powered by Alibaba's high-performance zvec vector library, zg bridges lexical and semantic retrieval, unifying ripgrep, BM25, and local vector search into a single command-line tool and agent integration. zg serves as a local-first search layer designed symmetrically for both human developers and autonomous AI coding agents. It indexes source code, documents, and structured configuration files locally, enabling queries that combine the precision of exact text matching with the discovery power of semantic embeddings. zg eliminates the trade-off between semantic search and exact matching: When autonomous coding agents such as Claude Code, Codex, or OpenCode explore repositories, broad scans and recursive grep calls quickly burn through context windows and rate limits. zg surfaces ranked, source-linked evidence snippets, enabling agents to pinpoint code locations in fewer tool calls with significantly lower token consumption. Data privacy is central to zg 's architecture. Source code, generated indexes, and local embedding models remain entirely on the developer's computer under .zvec-grep/ . No proprietary source code is uploaded to remote cloud APIs or third-party vector databases. zg operates effortlessly whether run directly by an engineer in a shell or invoked by an agent: Install globally requires Node.js 22+ npm install -g @zvec/zvec-grep Index your project using local embeddings zg index --embedding local/potion-retrieval-32m Search directly as a human zg query --human "How are authentication tokens validated?" --limit 3 Or install as an AI agent tool OpenCode, Claude Code, Cursor zg install --target opencode --yes By combining the lightning speed of regex search with the intelligence of local vector retrieval, zvec-grep modernizes repository navigation. It provides developers and AI assistants with a faster, privacy-preserving, and more intuitive search foundation. Want to bring semantic search to your terminal? Check out the zvec-grep GitHub Repository https://github.com/zvec-ai/zvec-grep .