コードベースをインデックス化し、コーディングエージェントが意味でコードを検索できる、ASTベースのセマンティックコード検索CLIおよびMCPサーバー。
yoanbernabeu/grepai
ローカル埋め込み、呼び出しグラフの追跡、AIコーディングエージェント向けMCPサーバーを備えた、プライバシー重視のセマンティックコード検索CLIです。
- スター
- 1,940
- フォーク
- 160
- 未解決の Issue
- 81
- 最終コミット
- 6 日前
これは何?
grepaiは、完全一致ではなく意味に基づいてコードベースを検索するコマンドラインツールです。埋め込みを使ってコードのベクトルインデックスを作成するため、「ユーザー認証フロー」のような自然言語のクエリから、異なる名前が付いていても関連する関数を見つけられます。
ツールはすべてローカルマシン上で動作し、Ollamaなどのローカル埋め込みプロバイダーを利用できます。LM StudioとOpenAIにも対応しています。バックグラウンドのファイルウォッチャーが、ファイルの変更に合わせてインデックスを更新します。また、呼び出しグラフを追跡できるため、関数を変更する前に、その関数を呼び出しているコードを確認できます。
grepaiはMCPサーバーとして動作し、Claude Code、Cursor、WindsurfなどのAIエージェントからツールとして呼び出せます。プロジェクトによると、生の検索結果ではなく絞り込まれたコンテキストをエージェントに渡すことで、コードを読む際に消費する入力トークンを削減できます。
主な機能
- 01完全一致ではなく意図に基づいてコードを照合するセマンティック検索
- 02関数の呼び出し元を特定する呼び出しグラフの追跡
- 03Ollama、LM Studio、OpenAIの埋め込みを使った完全ローカルでの動作
- 04インデックスを自動的に最新の状態に保つファイルウォッチャー
- 05AIエージェントからgrepaiを呼び出すためのMCPサーバー
ユースケース
- Claude CodeやCursorにファイル全体を読ませず、関連するコードを見つけてもらう
- 正確な関数名が分からないときに、概念を手がかりにコードを探す
- リファクタリング前に関数の呼び出し元を確認する
- コードを外部サービスに送信せず、非公開のコードベースを検索する
クイックスタート
- 1
Homebrew でインストール(macOS)
brew install yoanbernabeu/tap/grepai - 2
埋め込みプロバイダーをインストール:Ollama のモデル nomic-embed-text を pull
ollama pull nomic-embed-text - 3
プロジェクトで grepai を初期化し、インデックス作成デーモンを起動
grepai init && grepai watch - 4
コードを意味で検索
grepai search "error handling"
使う前に知っておきたいこと
- Ollama、LM Studio、OpenAI などの別途用意した埋め込みプロバイダーが必要です。
- README では、Linux と Windows のインストールにパッケージマネージャーではなく curl または PowerShell のインストールスクリプトを使用します。
収録されている特集
トピック
よくある質問
- grepai とは?
- ローカル埋め込み、呼び出しグラフの追跡、AIコーディングエージェント向けMCPサーバーを備えた、プライバシー重視のセマンティックコード検索CLIです。 grepaiは、完全一致ではなく意味に基づいてコードベースを検索するコマンドラインツールです。埋め込みを使ってコードのベクトルインデックスを作成するため、「ユーザー認証フロー」のような自然言語のクエリから、異なる名前が付いていても関連する関数を見つけられます。
- grepai は無料で使えますか?ライセンスは?
- grepai は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- grepai は今もメンテナンスされていますか?
- 活発にメンテナンス中。grepai の最終コミットは 2026年11月2日 です。
- grepai は何に使えますか?
- Claude CodeやCursorにファイル全体を読ませず、関連するコードを見つけてもらう 正確な関数名が分からないときに、概念を手がかりにコードを探す リファクタリング前に関数の呼び出し元を確認する コードを外部サービスに送信せず、非公開のコードベースを検索する
- grepai のインストール方法は?
- Homebrew でインストール(macOS): brew install yoanbernabeu/tap/grepai 埋め込みプロバイダーをインストール:Ollama のモデル nomic-embed-text を pull: ollama pull nomic-embed-text プロジェクトで grepai を初期化し、インデックス作成デーモンを起動: grepai init && grepai watch コードを意味で検索: grepai search "error handling"
- grepai はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/yoanbernabeu/grepai
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
ベクトル埋め込みとripgrepを組み合わせ、自然言語でコードベースを検索できるローカル優先のセマンティック検索エンジンです。
ripgrep、BM25、ベクトル検索を組み合わせ、ワークスペースをローカル優先で検索するCLI・エージェントツール。
OllamaまたはLM Studioの埋め込みを使い、Claude Code、Codex、Cursor、OpenCodeにコードベースの意味検索を提供するローカルMCPサーバー。
作り始める前に、自然な英語で書いた開発ツールのアイデアに合う既存ツールを、パッケージレジストリやGitHub、Hacker Newsから検索するCLI・TUIです。
Claude Code、Cursor、CopilotなどのAIコーディングエージェントを拡張する、検証済みスキルの厳選レジストリ。インストール用CLIも提供します。