marcoaapfortes/Mantic.sh

A structural code search engine for Al agents.

What it solves

Mantic は、AI エージェントや開発者向けにコンテキスト取得のオーバーヘッドを削減することを目的とした、コンテキスト認識型コード検索エンジンです。grep や ripgrep のようなツールでよく見られる「ノイズの多い」検索結果を、速度よりも関連性と意図を優先することで解決し、AI エージェントが最も適切なファイルだけを取得できるようにします。これによりトークン使用量が削減され、精度が向上します。

How it works

Mantic は、すべてのファイルを力技で読み込むのではなく、ファイル構造やメタデータから意図を推測するインフラ層を使用します。そのプロセスは次のとおりです。

  • Intent Analysis: クエリを UI、バックエンド、認証 などに分類し、CamelCase 検出とパスシーケンスマッチングで関連ファイルを見つけます。
  • Structural Scoring: 正確なファイル名一致、パスの関連性、ビジネスロジックの認識（例: .service.ts を .test.ts より高く評価）に基づいてファイルをランク付けします。
  • Hybrid Intelligence: ヒューリスティックスコアリングと、transformers.js を用いたローカル埋め込みによるセマンティック再ランク付けを組み合わせ、概念検索を実現します。
  • Code Intelligence: Tree‑sitter を利用して、モノレポ全体で「定義へジャンプ」や「参照検索」機能を提供します。
  • Learning: 成功した検索パターンをローカルに保存し、チーム間で知識を共有します。

Who it’s for

  • AI Agents: コーディングタスク向けに高品質でフィルタリングされたコンテキストを提供します。
  • Developers: 「支払いコードはどこ？」といった意図ベースの検索や、変更の「影響範囲（blast radius）」を分析したい場合に役立ちます。
  • Teams: ローカルファーストでプライバシーを保護し、Git にコミットできる検索ツールを求めるチーム向けです。

Highlights

  • MCP Server Support: Claude Desktop、Cursor、VS Code と Model Context Protocol を介して直接統合します。
  • Semantic Search: 正確なキーワード一致がなくても、概念的に関連するコードを見つけるためのニューラル再ランク付けをサポートします。
  • Zero-Query Mode: 変更されたファイルや関連する依存関係を表示して、コンテキストを自動的に提供します。
  • Local-First: 完全にローカルで実行され、データの外部送信がなく、プライバシーとコストゼロを実現します。
  • Cross-Repo Intelligence: モノレポ全体にわたる「定義へジャンプ」や「参照検索」を提供します。