miru

Miru (見る)

AI コーディングエージェント向けのハイブリッドコード検索です。

コードベースのどこで何が行われているかを尋ねると、Miru は MCP 経由で関連するファイルパス、行番号、ソースコードの抜粋を返します。

インストール

Bun 1.1 以降が必要です。bunx が PATH に含まれていることを確認してください。

Claude Code（推奨）

Claude Code 内で実行します：

/plugin marketplace add takara-ai/miru-code
/plugin install miru@miru

プラグインを再読み込みするか Claude Code を再起動してから、次のように尋ねます：

Use Miru to find where authentication is configured in this project.

認証情報が見つからない場合、Claude は Miru の auth ツールを使ってサインインを開始できます。ログインコードを承認してから、検索を再試行してください。プラグインの認証情報は CLI の認証情報とは別です。

その他のエージェント

Codex および Cursor のプラグインについては、エージェント連携をご覧ください。Cursor プラグインにはスキルとルールが用意されています。MCP ツールを接続するには、以下の CLI インストーラーを使用してください。

インストール（CLI による代替方法）

ターミナルでの使用、または CLI 経由で設定するエージェントの場合：

bun add -g @takara-ai/miru-code
miru setup
miru install

インストーラーでエージェントを選択し、再起動してください。対応する連携をご覧ください。設定を削除するには miru uninstall を使用します。

試してみる

miru search "auth middleware" ./src
miru locate REDIS_HOST ./src
miru expand src/auth.ts 42 ./src
miru find-related src/auth.ts 42 ./src

スクリプトでは --json を使用してください。オプションを確認するには miru <command> -h を実行します。

MCP ツール

ツール	用途
search	意味からコードを検索する
locate	文字列の完全一致、正規表現の一致、またはファイル名を検索する
expand	同じファイル内の隣接するチャンクを読み込む
find_related	他のファイルにある類似コードを検索する
auth	サインインするか、SageMaker エンドポイントを設定する
read_benchmark	ベンチマークモードが有効な場合に、トークン削減の合計を読み取る

省略可能な repo 引数の既定値は、サーバーの作業ディレクトリです。Miru は初回使用時にインデックスを構築し、ローカルファイルの変更を監視します。

仕組み

Miru は埋め込み、BM25、コードを考慮したランキングを組み合わせます。Tree-sitter は 26 言語に対応した構文認識チャンクを提供し、それ以外のファイルには構造ベースおよび行ベースのフォールバックを使用します。

チャンク分割とキャッシュおよびランキング評価をご覧ください。

プライバシーと API の使用

既定では、Miru はファイルの内容をソースチャンクとして、検索クエリを埋め込み処理のために HTTPS 経由で Takara に送信します。API の使用には、Takara のプランに応じて費用が発生する場合があります。

独自のインフラストラクチャで埋め込みを行うには、AWS SageMaker を使用してください。ローカルの MCP リポジトリパスを 1 つのディレクトリに制限するには、MIRU_WORKSPACE_ROOT を設定します。

ドキュメント

• リファレンス：CLI コマンド、MCP パラメーター、設定、ベンチマーク
• エージェント連携：プラグインの機能、設定パス、任意のスキル
• コントリビューション：開発環境のセットアップ、チェック、リリース

クレジット

Miru は MinishLab の成果を基盤としています：

• semble：ファイルの走査、インデックス作成、BM25、ハイブリッド検索、ランキングシグナル。
• potion-code と Model2Vec：WordPiece トークナイザー。

著作権表示とライセンス文については、NOTICEをご覧ください。

ライセンス

MIT