Repolode
yoanbernabeu

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. 1

    Homebrew でインストール(macOS)

    brew install yoanbernabeu/tap/grepai
  2. 2

    埋め込みプロバイダーをインストール:Ollama のモデル nomic-embed-text を pull

    ollama pull nomic-embed-text
  3. 3

    プロジェクトで grepai を初期化し、インデックス作成デーモンを起動

    grepai init && grepai watch
  4. 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 の数値は毎日更新されます。

関連プロジェクト