このプロジェクトについて

mgrepは、ローカルファイルに意味的・自然言語検索をもたらすコマンドラインツールで、grepの代替ではなく補完として位置づけられています。これはnpmパッケージ(@mixedbread/mgrep)としてApache-2.0ライセンスで配布され、Mixedbreadによって構築されています。 中核機能: - コード、テキスト、PDF、画像に対する自然言語検索。音声と動画のサポートは近日公開予定とされています。 - `mgrep watch`によるバックグラウンドインデックス作成。初期同期を実行し、.gitignoreとオプションの.mgrepignoreファイルを尊重し、ファイル変更に応じてクラウドバックアップのMixedbreadストアを更新します。 - `--web`によるWeb検索。ローカル結果とともに`mixedbread/web`ストアをクエリします。`--answer`は要約された応答を生成します。 - `--agentic`によるエージェント的検索。複雑な質問をサブクエリに分割し、複数の検索を実行します。 - デフォルトでの結果の再ランキング。`--no-rerank`またはMGREP_RERANK=0で無効化可能。 - 結果には相対パスと、テキストの行範囲やPDFのページ番号などの文脈ヒントが含まれます。 認証とセットアップ: - `mgrep login`はデバイス/ブラウザフローを使用します。ヘッドレスまたはCI環境では、代わりにMXBAI_API_KEYを設定できます。 - インストールは`npm install -g @mixedbread/mgrep`(pnpm/bunも言及)で行います。 コーディングエージェント統合: - Claude Code、OpenCode、Codex、Factory Droid用の支援インストールコマンドが存在します(install-claude-code、install-opencode、install-codex、install-droid)。 - READMEには、コーディングエージェントと一緒にインストールすると、バックグラウンドプロセスがセッション中にファイルを同期し、セッション終了時に停止すると記載されています。 - デフォルトの制限はファイルあたり1MB、ディレクトリあたり1,000ファイルで、CLIフラグ、環境変数、または設定ファイルで調整可能です。 設定: - ローカルの`.mgreprc.yaml`/`.mgreprc.yml`またはグローバルの`~/.config/mgrep/config.yaml`。 - 優先順位:CLIフラグ、次に環境変数、次にローカル設定、次にグローバル設定、最後にデフォルト。 - 環境変数は、認証(MXBAI_API_KEY)、ストア選択(MXBAI_STORE)、検索動作(MGREP_MAX_COUNT、MGREP_CONTENT、MGREP_ANSWER、MGREP_WEB、MGREP_AGENTIC、MGREP_SYNC、MGREP_DRY_RUN、MGREP_RERANK)、同期制限(MGREP_MAX_FILE_SIZE、MGREP_MAX_FILE_COUNT)をカバーします。 - `--store <name>`はワークスペースを分離します。ストアはオンデマンドで作成されます。 コマンド概要:`mgrep`/`mgrep search`、`mgrep watch`、`mgrep login`、`mgrep logout`、および4つのエージェントインストールコマンド。 開発:pnpmで構築されたTypeScriptプロジェクト。`pnpm build`、`pnpm dev`、`pnpm format`(biome)、`pnpm typecheck`。テストはbatsを使用します。READMEにはテストはまだ完全には配線されていないと記載されています。 ベンチマークの主張:READMEは、mgrepをClaude Codeで使用した場合、grepベースのワークフローと比較して約2倍少ないトークンを使用し、同等以上の品質評価(LLMによる勝率判定)を得たという内部の50タスクQAベンチマークを報告しています。これらはプロジェクト自身の主張であり、ここで独立に検証されたものではありません。 トラブルシューティングのメモは、繰り返されるログインプロンプト、ノイズの多いウォッチャー、ストアの再作成をカバーしています。サポートはMixedbread Slackコミュニティを通じて提供されています。