mgrep-code-search について
mgrep-code-searchは、自然言語でコードやその他のリポジトリ内ファイルを意味検索するスキルです。文字列の一致ではなく概念から実装箇所を探し、複雑なコードベースの調査に役立ちます。
主な機能
- 01自然言語による意味検索
- 02コード、テキスト、PDF、画像の検索
- 03リポジトリのインデックス作成と変更監視
- 04パスや結果数による絞り込み
- 05一致内容やAIによる要約の表示
活用シーン
- 01機能の実装箇所の特定
- 02未知のコードベースの調査
- 03ネストしたディレクトリから概念を検索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/mgrep-code-searchを入力して読み込まれたか確認します。
詳細
mgrep コード検索
概要
mgrep は、コード、テキスト、PDF、画像を自然言語で検索できるセマンティック検索ツールです。従来のパターンマッチングでは対応しきれない、大規模または複雑なコードベースの調査に特に効果的です。
このスキルを使用するタイミング
次の場合は mgrep を使用してください：
- コードベースに、Git で無視されないファイルが 30 個を超えて含まれている
- ディレクトリ構造が入れ子になっている
- 完全一致する文字列ではなく、概念、機能、意図を検索する
- 不慣れなコードベースを調査する
- 何かが「どこで」または「どのように」実装されているかを理解する必要がある
次の場合は従来の grep/ripgrep を使用してください：
- 完全一致するパターンやシンボルを検索する
- 正規表現ベースのリファクタリングを行う
- 特定の関数名や変数名を追跡する
クイックスタート
インデックス作成
検索の前に、リポジトリのインデックスを作成するウォッチャーを起動します：
bunx @mixedbread/mgrep watch
watch コマンドはリポジトリのインデックスを作成し、ファイルの変更との同期を維持します。.gitignore と .mgrepignore のパターンに従います。
検索
bunx @mixedbread/mgrep "your natural language query" [path]
検索コマンド
基本検索
bunx @mixedbread/mgrep "where is authentication configured?"
bunx @mixedbread/mgrep "how do we handle errors in API calls?" src/
bunx @mixedbread/mgrep "database connection setup" src/lib
検索オプション
| オプション | 説明 |
|---|---|
-m <count> | 結果の最大件数（デフォルト：10） |
-c, --content | 結果の内容全体を表示 |
-a, --answer | AI による結果の統合を生成 |
-s, --sync | 検索前にインデックスを更新 |
--no-rerank | 関連性の最適化を無効化 |
オプションを使った例
# Get more results
bunx @mixedbread/mgrep -m 25 "user authentication flow"
# Show full content of matches
bunx @mixedbread/mgrep -c "error handling patterns"
# Get an AI-synthesised answer
bunx @mixedbread/mgrep -a "how does the caching layer work?"
# Sync index before searching
bunx @mixedbread/mgrep -s "payment processing" src/services
ワークフロー
-
ウォッチャーを起動（セッションごと、またはファイルに大きな変更があったときに一度実行します）：
bunx @mixedbread/mgrep watch -
セマンティック検索を実行：
bunx @mixedbread/mgrep "what you're looking for" [optional/path] -
必要に応じてパス制約やオプションを使って絞り込む：
bunx @mixedbread/mgrep -m 20 -c "refined query" src/specific/directory
環境変数
環境変数を使ってデフォルト値を設定します：
| 変数 | 用途 |
|---|---|
MGREP_MAX_COUNT | 結果のデフォルト上限 |
MGREP_CONTENT | 内容表示を有効化（1/true） |
MGREP_ANSWER | AI による統合を有効化（1/true） |
MGREP_SYNC | 検索前の同期（1/true） |
重要な注意事項
- コマンドの実行には必ず
bunx @mixedbread/mgrepを使用してください（npm/npx や直接インストールは使用しないでください） - インデックスを最新の状態に保つため、検索前に
bunx @mixedbread/mgrep watchを実行してください - mgrep は
.gitignoreのパターンに自動的に従います - 追加の除外対象を指定するには
.mgrepignoreを作成してください
コメント
Markdown 対応