grepai

grepaiはセマンティックなコード検索のためのオープンソースCLIで、開発者Yoan Bernabeuが作り、MITライセンスで公開されている。名前は1973年のオリジナルgrepへのオマージュだが、考え方は違う。古典的なgrepはテキストパターンに一致する。grepaiは関数やクラスをベクトルに変換し、意味に一致させる。だから「error handling」を検索すると、catchExceptionという関数が浮かび上がる。そんな名前を打とうとは思いつかないだろう。

このツールは2つの層に向けて作られた。1つ目は、大きなリポジトリでシンボル名を推測するのに疲れた開発者だ。2つ目はAIコーディングエージェントで、何かを理解する前にgrepとファイルの読み直しで大量のトークンを消費する。エージェントに生の検索出力ではなく関連コードの短いリストを渡すことで、grepaiはエージェントが必要とする入力トークンを削る。r/ClaudeAIのユーザーはまさにそう報告している。ある開発者は、Claude Codeの入力トークンが大きく減ったと語った。

最大の制約はセットアップだ。grepaiはコードをベクトルに変換する埋め込みプロバイダーを必要とする。つまりOllamaをインストールしてモデルを取得するか、クラウドプロバイダーのAPIキーを渡す必要がある。一度実行して忘れられるコマンドではない。低スペックのマシンでは、大きなリポジトリの初回インデックスにも時間がかかる。ターミナルで暮らす開発者には割のいい取引だ。それ以外の人には、たぶん望む以上の機構だ。

はじめかた

1. OS向けのワンラインスクリプトでgrepaiをインストールする。macOSならHomebrewでもよい。WindowsではGitHubページからPowerShellコマンドを取得する。
2. Ollama用の埋め込みモデルを取得する。通常はnomic-embed-textだ。ローカル埋め込みならコードは自分のマシンにとどまる。
3. プロジェクト内でgrepai initを実行し、設定を作成してインデックスを用意する。
4. grepai watchを起動すると、ファイル監視が編集中もインデックスを最新に保つ。
5. grepai search "error handling"で平易な英語で検索するか、grepai trace callers "Login"で関係を追跡する。