Zvec-Grep (zg)とは？
zg として実行する Zvec-Grep は、ワークスペースをインデックス化し、完全一致、BM25 のキーワード順位付け、ベクトル類似度、またはそれらを融合したハイブリッドで検索に答え、パス、シンボル、行番号付きの順位付き抜粋を返します。ベクトルデータベース zvec の上に作られ、コマンドラインとローカルの MCP サーバーの両方を提供します。既定でエージェントに見えるのは、言い回しや場所が分からない質問向けの zvec_grep_search という一つのツールだけで、完全版のツールセットでは rg、インデックス管理、ステータスのツールが加わります。
ライセンスは Apache-2.0 で、npm に @zvec/zvec-grep として公開され、macOS、Linux、Windows で動きます。2026 年 11 月 3 日公開のバージョン 0.3.0 でコアが Rust で書き直されました。リポジトリのスターは約 4,260、未解決の issue とプルリクエストは 92 件で、npm パッケージの直近 1 か月のダウンロードは約 12,189 件です。
Zvec-Grep (zg)のインストール方法
npm install -g @zvec/zvec-grep --allow-scripts=@zvec/zvec-grep && zg --install --target claudeZvec-Grep (zg)は使う価値があるか？
要となる設計判断は抑制です。競合するコードコンテキスト系サーバーのいくつかが多数のツールを公開するのに対し、zg のエージェント向け既定ツールセットは zvec_grep_search の一つだけで、ドキュメントは完全一致の語、ファイル名、正規表現には引き続きエージェント自身の grep を使うよう指示しています。検索は意味をとらえるベクトル類似度と、識別子を押さえる BM25 を組み合わせるので、ユーザー権限はどこで確認されているか、といった質問でも、関数名を誰も知らないまま正しい関数にたどり着けます。
プライバシーの既定値は慎重に引かれています。インデックスはプロジェクト内の .zvec-grep に、モデルは ~/.zvec-grep/models に置かれ、既定の埋め込みモデル potion-code-16m-v2 はローカルで動きます。ローカルモデルは 16m パラメータの Model2Vec から GGUF 形式の Qwen3 Embedding 0.6B まで 11 種類が挙げられています。三つのリモート Qwen モデルには API キーに加えて別途同意の付与が必要で、キーだけではワークスペースの内容を送る許可にはならず、--allow-remote かワークスペース単位の許可が要ります。任意の HTTP サーバーは 127.0.0.1:7999 で待ち受け、ループバックでは既定で認証が無効ですが、トークンファイルを使えば bearer 認証が有効になります。
0.3.0 での Rust への書き直しは、若いプロジェクトにとって大きな変更です。75,128 件の文書を使ったメンテナー自身のテストでは、パッケージサイズが 167.5 MiB から 34.3 MiB に、インデックス作成の合計時間が 219.13 s から 77.84 s に減り、ピークメモリは 53.2% 下がり、MCP の検索レイテンシは 20.93 ms から 14.88 ms になりました。いずれも開発元の数値で、Claude Code と Codex を使ったエージェントの A/B ベンチマークも同様です。README 自身も、結果はモデルや実行ごとに変わると述べています。未解決の issue とプルリクエストが 92 件あり、埋め込みモデルを変えるたびにインデックスを作り直す必要があるため、チームの標準にする前に一つのリポジトリで試す価値があります。
真価を発揮する場面
30 万行の Django コードベースに加わったばかりのバックエンド開発者
関数名が分からないまま、業務ルールがどこで適用されているかを探す
zg --index を一度実行し、zg --install --target claude で Claude Code に導入して、grep に頼る前にエージェントに zvec_grep_search を呼ばせます。ローカルモデルなら無料で、インデックス作成時間はリポジトリの規模に比例して伸びます。
報告書やメモのフォルダーを抱える政策アナリスト
エージェントを使わず、ターミナルから文書を意味で検索する
英語の文書なら local/potion-retrieval-32m でインデックスを作り、zg --preview detail で照会します。結果はファイルと行の参照付きで順位付けされ、何もノート PC の外に出ませ ん。
20 人のエンジニアにエージェント用ツールを展開するプラットフォームチーム
エディターが違っても全員に同じ意味検索を提供する
チームの対象（codex、claude、cursor、vscode）向けに zg --install をスクリプト化し、ツール一つの既定ツールセットを維持します。共有の Qwen モデルを使うなら、リモート埋め込みはグローバルではなくワークスペース単位で許可します。
導入前に確認すること
- 導入
- npm install -g @zvec/zvec-grep --allow-scripts=@zvec/zvec-grep を実行し、プロジェクトで zg --index、続いて zg --install --target <client>。その後エージェントを再起動します。インデックスはプロジェクトのルートの .zvec-grep に保存されます。
- 連携
- 導入先は codex、claude、qwen、qoder、opencode、cursor、copilot、vscode、grok、pi など。MCP は既定で stdio、または zg --server on で HTTP。--mcp-toolset full で rg、インデックス、ステータスのツールが加わります。
- データとプライバシー
- ファイル、インデックス、ローカルモデルはマシン上にとどまりま す。リモートの Qwen 埋め込みは、--allow-remote かワークスペース単位の許可があって初めて、許可されたワークスペースの内容とクエリを提供元に送ります。許可は取り消せます。
- 大規模利用時のコスト
- ローカルモデルなら無料です。リモートの Qwen 埋め込みは DashScope の料金に従って提供元が請求しますが、zg のドキュメントには金額が載っていません。
- 制限
- マルチモーダルの埋め込みモデルでもテキストのみ。モデルやエンドポイントを変えるとインデックスの再構築が必要です。127.0.0.1:7999 の HTTP サーバーはループバックでは既定で認証が無効です。
良い点
- 既定の MCP ツールが一つだけでエージェントのコンテキストを小さく保てる
- 既定でローカルの埋め込みモデルを使い、何もマシンの外に出ない
- リモート埋め込みには明示的な同意の付与が必要
- Claude、Codex、Cursor などに一つのコマンドで導入
気になる点
- ベンチマークはメンテナー自身によるもの
- Rust への全面書き直し後に未解決の issue と PR が 92 件
- 埋め込みモデルを変えると全体の再インデックスが必要
- ローカルの HTTP サーバーは既定で認証なし
おすすめの人
リポジトリを埋め込み API に送らずに、コーディングエージェントにコードや文書を意味で探させたい開発者や研究者。
Zvec-Grep (zg)の代替
Zvec-Grep (zg)：よくある質問
- Zvec-Grep (zg)は使う価値があるか？
- エージェント向けによく考えられたローカル検索ツールで、MCP の窓口をツール一つに絞り、リモート埋め込みを既定ではなく明示的に選ぶものにしています。 評価は5点満点中4.0点です。
- Zvec-Grep (zg)の料金は？
- 無料のオープンソース（Apache-2.0）。ローカルの埋め込みモデルは無料で、任意の Qwen のリモート埋め込みには DashScope の API キーが必要となり、料金はその提供元が請求します。
- Zvec-Grep (zg)の欠点は？
- ベンチマークはメンテナー自身によるもの; Rust への全面書き直し後に未解決の issue と PR が 92 件; 埋め込みモデルを変えると全体の再インデックスが必要; ローカルの HTTP サーバーは既定で認証なし.
- Zvec-Grep (zg)は誰に向いているか？
- リポジトリを埋め込み API に送らずに、コーディングエージェントにコードや文書を意味で探させたい開発者や研究者。
- チームや本番環境でZvec-Grep (zg)を使うと費用はいくらか？
- ローカルモデルなら無料です。リモートの Qwen 埋め込みは DashScope の料金に従って提供元が請求しますが、zg のドキュメント には金額が載っていません。
- Zvec-Grep (zg)は企業データを扱っても安全か？
- ファイル、インデックス、ローカルモデルはマシン上にとどまります。リモートの Qwen 埋め込みは、--allow-remote かワークスペース単位の許可があって初めて、許可されたワークスペースの内容とクエリを提供元に送ります。許可は取り消せます。
- Zvec-Grep (zg)の代わりになるものは？
- 当サイトでレビューした中で最も近い代替はSerena, CodeGraph, Semble 、 Project RAGです。
回答確認日：2026年11月6日
Zvec-Grep (zg)の開発元の方へ：この評価をサイトに掲載できます
