Was ist Zvec-Grep (zg)?
Zvec-Grep, aufgerufen als zg, indexiert einen Arbeitsbereich und beantwortet Suchen per exakter Übereinstimmung, BM25-Stichwortranking, Vektorähnlichkeit oder einer fusionierten Hybridsuche und liefert gerankte Passagen mit Pfaden, Symbolen und Zeilennummern. Es baut auf der Vektordatenbank zvec auf und bedient sowohl eine Kommandozeile als auch einen lokalen MCP-Server. Standardmäßig sehen Agenten ein einziges Tool, zvec_grep_search, gedacht für Fragen, bei denen Wortlaut oder Fundort unbekannt sind; ein volles Toolset ergänzt rg, Indexverwaltung und Status-Tools.
Es steht unter Apache-2.0, ist auf npm als @zvec/zvec-grep veröffentlicht und läuft unter macOS, Linux und Windows. Version 0.3.0 vom 3. November 2026 schrieb den Kern in Rust neu. Das Repository hat rund 4.260 Sterne und 92 offene Issues und Pull Requests, und das npm-Paket kam im letzten Monat auf etwa 12.189 Downloads.
Zvec-Grep (zg) installieren
npm install -g @zvec/zvec-grep --allow-scripts=@zvec/zvec-grep && zg --install --target claudeLohnt sich Zvec-Grep (zg)?
Die entscheidende Designentscheidung ist Zurückhaltung. Während mehrere konkurrierende Code-Kontext-Server viele Tools anbieten, besteht das Standard-Toolset von zg für Agenten aus einem, zvec_grep_search, und die Doku weist den Agenten an, für exakte Wörter, Dateinamen und reguläre Ausdrücke weiter sein eigenes grep zu nutzen. Die Suche verbindet Vektorähnlichkeit für die Bedeutung mit BM25 zur Verankerung von Bezeichnern, sodass eine Frage wie die, wo Benutzerrechte geprüft werden, auf der richtigen Funktion landen kann, auch wenn niemand ihren Namen kennt.
Die Datenschutz-Voreinstellungen sind sorgfältig gezogen. Indizes liegen in .zvec-grep im Projekt, Modelle in ~/.zvec-grep/models, und das Standard-Embedding-Modell potion-code-16m-v2 läuft lokal; elf lokale Modelle sind aufgeführt, von Model2Vec mit 16m Parametern bis Qwen3 Embedding 0.6B im GGUF-Format. Die drei entfernten Qwen-Modelle brauchen einen API-Schlüssel und zusätzlich eine Zustimmung: Ein Schlüssel allein erlaubt nicht, Inhalte des Arbeitsbereichs zu senden; dafür braucht es --allow-remote oder eine auf den Arbeitsbereich begrenzte Freigabe. Der optionale HTTP-Server lauscht auf 127.0.0.1:7999, auf Loopback standardmäßig ohne Authentifizierung; eine Token-Datei schaltet Bearer-Authentifizierung ein.
Der Rust-Neubau in 0.3.0 ist ein großer Schritt für ein junges Projekt. Im eigenen Test der Maintainer über 75.128 Dokumente sank die Paketgröße von 167,5 MiB auf 34,3 MiB, die gesamte Indexierzeit von 219,13 s auf 77,84 s, der Spitzenspeicher um 53,2% und die MCP-Suchlatenz von 20,93 ms auf 14,88 ms. Das sind Herstellerzahlen, ebenso wie die A/B-Agentenbenchmarks mit Claude Code und Codex, und das README sagt selbst, dass die Ergebnisse je nach Modell und Lauf schwanken. Mit 92 offenen Issues und Pull Requests und einem Index, der bei jedem Wechsel des Embedding-Modells neu gebaut werden muss, lohnt ein Test an einem Repository, bevor es Teamstandard wird.
Wo es sich lohnt
Ein Backend-Entwickler, neu in einer Django-Codebasis mit 300.000 Zeilen
Finden, wo eine Geschäftsregel durchgesetzt wird, ohne den Funktionsnamen zu kennen
Einmal zg --index ausführen, mit zg --install --target claude in Claude Code installieren und den Agenten zvec_grep_search aufrufen lassen, bevor er auf grep zurückgreift. Mit lokalem Modell kostenlos; die Indexierzeit wächst mit der Größe des Repositorys.
Eine Politikanalystin mit einem Ordner voller Berichte und Notizen
Dokumente ohne Agenten im Terminal nach Bedeutung durchsuchen
Mit local/potion-retrieval-32m für englische Dokumente indexieren und mit zg --preview detail abfragen. Die Ergebnisse kommen gerankt mit Datei- und Zeilenangaben; nichts verlässt den Laptop.
Ein Plattformteam, das Agenten-Werkzeuge für 20 Engineers einführt
Allen dieselbe semantische Suche in verschiedenen Editoren geben
zg --install für die Ziele des Teams (codex, claude, cursor, vscode) per Skript ausrollen und das Standard-Toolset mit einem Tool beibehalten. Soll ein gemeinsames Qwen-Modell genutzt werden, entfernte Embeddings pro Arbeitsbereich freigeben statt global.
Bevor du dich festlegst
- Einrichtung
- npm install -g @zvec/zvec-grep --allow-scripts=@zvec/zvec-grep, dann zg --index im Projekt und zg --install --target <client>. Danach den Agenten neu starten. Der Index liegt in .zvec-grep im Projektstamm.
- Integrationen
- Installationsziele sind unter anderem codex, claude, qwen, qoder, opencode, cursor, copilot, vscode, grok und pi. MCP standardmäßig über stdio oder über HTTP mit zg --server on. --mcp-toolset full ergänzt rg-, Index- und Status-Tools.
- Daten und Datenschutz
- Dateien, Indizes und lokale Modelle bleiben auf dem Rechner. Entfernte Qwen-Embeddings senden freigegebene Inhalte des Arbeitsbereichs und Anfragen erst nach --allow-remote oder einer Arbeitsbereichsfreigabe an den Anbieter; die Freigabe lässt sich widerrufen.
- Kosten im großen Maßstab
- Mit lokalen Modellen kostenlos. Entfernte Qwen-Embeddings rechnet der Anbieter nach den DashScope-Preisen ab, die die zg-Doku nicht nennt.
- Grenzen
- Nur Text, auch mit multimodalen Embedding-Modellen. Ein Wechsel von Modell oder Endpunkt erfordert einen Neuaufbau. Der HTTP-Server auf 127.0.0.1:7999 hat auf Loopback standardmäßig keine Authentifizierung.
Was gut ist
- Ein einziges MCP-Tool hält den Agentenkontext klein
- Standardmäßig lokale Embedding-Modelle; nichts verlässt den Rechner
- Entfernte Embeddings brauchen eine ausdrückliche Zustimmung
- Installation per Befehl für Claude, Codex, Cursor und andere
Was nicht
- Benchmarks stammen von den Maintainern selbst
- 92 offene Issues und PRs nach einem kompletten Rust-Neubau
- Ein Wechsel des Embedding-Modells erzwingt eine Neuindexierung
- Lokaler HTTP-Server standardmäßig ohne Authentifizierung
Am besten für
Entwickler und Forschende, die ihren Coding-Agenten Code und Dokumente nach Bedeutung finden lassen wollen, ohne das Repository an eine Embedding-API zu schicken.
Alternativen zu Zvec-Grep (zg)
Zvec-Grep (zg): häufige Fragen
- Lohnt sich Zvec-Grep (zg)?
- Ein durchdachtes lokales Suchwerkzeug für Agenten, das seine MCP-Oberfläche auf ein Tool beschränkt und entfernte Embeddings zur ausdrücklichen Wahl macht, nicht zum Standard. Wir bewerten es mit 4.0 von 5.
- Was kostet Zvec-Grep (zg)?
- Kostenlos und quelloffen (Apache-2.0). Lokale Embedding-Modelle sind kostenlos; die optionalen entfernten Qwen-Embeddings brauchen einen DashScope-API-Schlüssel und werden von diesem Anbieter abgerechnet.
- Welche Nachteile hat Zvec-Grep (zg)?
- Benchmarks stammen von den Maintainern selbst; 92 offene Issues und PRs nach einem kompletten Rust-Neubau; Ein Wechsel des Embedding-Modells erzwingt eine Neuindexierung; Lokaler HTTP-Server standardmäßig ohne Authentifizierung.
- Für wen eignet sich Zvec-Grep (zg)?
- Entwickler und Forschende, die ihren Coding-Agenten Code und Dokumente nach Bedeutung finden lassen wollen, ohne das Repository an eine Embedding-API zu schicken.
- Was kostet Zvec-Grep (zg) für ein Team oder im Produktivbetrieb?
- Mit lokalen Modellen kostenlos. Entfernte Qwen-Embeddings rechnet der Anbieter nach den DashScope-Preisen ab, die die zg-Doku nicht nennt.
- Ist Zvec-Grep (zg) sicher für Firmendaten?
- Dateien, Indizes und lokale Modelle bleiben auf dem Rechner. Entfernte Qwen-Embeddings senden freigegebene Inhalte des Arbeitsbereichs und Anfragen erst nach --allow-remote oder einer Arbeitsbereichsfreigabe an den Anbieter; die Freigabe lässt sich widerrufen.
- Was sind die besten Alternativen zu Zvec-Grep (zg)?
- Die nächsten Alternativen, die wir getestet haben, sind Serena, CodeGraph, Semble und Project RAG.
Antworten geprüft am 6. Nov. 2026.
Du entwickelst Zvec-Grep (zg)? Zeig diese Bewertung auf deiner Website
