zvec-ai/zvec-grep

これは何？

主な機能

• 01ripgrepによる完全一致・正規表現検索、BM25によるキーワードランキング、ベクトルによる意味検索を組み合わせます。
• 02ターミナルからzg CLIで使えるほか、MCP形式の連携を通じてAIエージェントからも利用できます。
• 03ソースコード、ドキュメント、構造化データを、ソース上の位置情報を保持したままインデックス化します。
• 04macOS、Linux、Windowsで動作し、npmパッケージにはNode.js 22以降が必要です。
• 05デフォルトでは、ファイル、インデックス、ローカルモデルをマシン内に保持します。

ユースケース

• 正確なシンボル名がわからないときに、大規模なリポジトリからコードの処理経路やアーキテクチャの詳細を探す。
• AIコーディングエージェントにローカルプロジェクトを検索させ、ランキング付きでソースに紐づいた結果を得る。
• 文書とコードが混在するフォルダーを、完全一致のキーワードではなく意味で検索する。
• ファイルをリモートサービスに送信せず、プライベートな意味検索を実行する。

クイックスタート

1. 1

   npm から zg CLI をインストールします（Node.js 22 以降が必要です）

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

   ローカルの埋め込みモデルでワークスペースをインデックス化します

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

   ターミナルから検索を実行します

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

使う前に知っておきたいこと

• !Node.js 22 以降が必要です。
• !エージェントの例は OpenCode と無料モデルの利用可否に依存し、状況は変わる場合があります。

収録されている特集

トピック

よくある質問

zvec-grep とは？

ripgrep、BM25、ベクトル検索を組み合わせ、ワークスペースをローカル優先で検索するCLI・エージェントツール。 zg（zvec-grep）は、ワークスペース内のファイルを検索するローカル検索ツールです。ripgrepによる完全一致・正規表現検索、BM25によるキーワードランキング、意味ベースのベクトル検索を組み合わせており、クエリの意味から該当箇所を見つけ、必要に応じて完全一致のテキストで確認できます。zvecベクトルデータベースを基盤としており、Node.jsパッケージとして利用できます。READMEではTypeScript/Node.js実装が説明されており、リポジトリには別途Rust実装もあります。

zvec-grep は無料で使えますか？ライセンスは？

zvec-grep は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

zvec-grep は今もメンテナンスされていますか？

活発にメンテナンス中。zvec-grep の最終コミットは 2026年11月6日 です。

zvec-grep は何に使えますか？

正確なシンボル名がわからないときに、大規模なリポジトリからコードの処理経路やアーキテクチャの詳細を探す。 AIコーディングエージェントにローカルプロジェクトを検索させ、ランキング付きでソースに紐づいた結果を得る。 文書とコードが混在するフォルダーを、完全一致のキーワードではなく意味で検索する。 ファイルをリモートサービスに送信せず、プライベートな意味検索を実行する。

zvec-grep のインストール方法は？

npm から zg CLI をインストールします（Node.js 22 以降が必要です）: npm install -g @zvec/zvec-grep ローカルの埋め込みモデルでワークスペースをインデックス化します: zg index --embedding local/potion-retrieval-32m ターミナルから検索を実行します: zg query --human "An unseen creature left a few marks. What did the detective infer?" --limit 3

zvec-grep はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/zvec-ai/zvec-grep