
2026/01/06 22:48
**Show HN:Mantic.sh ― AI エージェントのための構造的コード検索エンジン**
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
Summary:
Mantic は軽量でローカルに動作するコード検索ツールです。大規模リポジトリでも 0.5 秒未満で結果を返し、トークン使用量(最大 63% 削減)と外部 API コストをゼロにします。ベンチマークでは数千ファイルで 0.32–0.46 秒、通常のベクトル検索なら 5–10 秒という高速性が確認され、決定論的スコアリングとインパクト分析により結果の信頼性を保証します。バージョン 1.0.13 では便利な環境変数(
MANTIC_IGNORE_PATTERNS、MANTIC_MAX_FILES、MANTIC_TIMEOUT)が追加され、正規表現のバグも修正されました。これにより Git ネイティブスキャンと MCP(Claude Desktop、Cursor)との統合が可能になりました。今後の更新ではスコアリングの洗練化、ネイティブ MCP サポートの拡充、およびインパクト分析の深化が期待されます。開発者やチームにとって、Mantic は高速かつ費用対効果の高い検索を提供し、コード探索・保守方法を再構築できる可能性があります。埋め込み機能の商用利用にはライセンスが必要です。
Summary Skeleton
What the text is mainly trying to say (main message)
Mantic は高速でローカルに動作するコード検索ツールで、非常に大きなリポジトリでも 500 ms 未満の取得時間を実現しつつ、トークン使用量とコストを劇的に削減します。
Evidence / reasoning (why this is said)
ベンチマークは数千から数十万ファイルで 0.32–0.46 秒、対してベクトル検索では 5–10 秒という結果を示し、トークン節約率が最大 63% に達します。外部 API を使用せずデータのアウトゲージもゼロで、決定論的スコアリングとインパクト分析により結果の信頼性が担保されます。
Related cases / background (context, past events, surrounding info)
バージョン v1.0.13 では環境変数(
MANTIC_IGNORE_PATTERNS、MANTIC_MAX_FILES、MANTIC_TIMEOUT)が導入され、無視パターンの正規表現に関するバグも修正されました。ツールは Git ネイティブスキャンをサポートし、Claude Desktop と Cursor を含む MCP との統合にも対応しています。
What may happen next (future developments / projections written in the text)
今後のリリースではスコアリングのさらなる最適化、ネイティブ MCP サポートの拡張、およびインパクト分析機能の深化が行われる可能性があります。費用優位性により、開発者やチームでの採用が広がる見込みです。
What impacts this could have (users / companies / industry)
個人開発者と社内チームは時間とコストを節約できます。商用利用では埋め込み機能に対してライセンスが必要です。低レイテンシーと決定論的結果により、コード検索の統合方法や製品パイプラインに変化をもたらす可能性があります。
本文
Mantic
A AI エージェント向けの構造コード検索エンジン
埋め込みやベクトルデータベース、外部依存無しに、大規模コードベースを500 ms以内でファイル順位付けします。
v1.0.13 の新機能
-
環境変数 – 以前動作していなかった3つの変数を実装
– 除外したいファイルをカンマ区切りで指定(glob パターン)MANTIC_IGNORE_PATTERNS
– 戻るファイル数上限(デフォルト:300)MANTIC_MAX_FILES
– 検索タイムアウト(ミリ秒、デフォルト:5000 ms)MANTIC_TIMEOUT
-
バグ修正 – 無視パターンが機能しない原因だった glob パターンの正規表現を修正。
-
性能向上 – 非常に大きなリポジトリでハングするのを防ぐタイムアウトラッパーを追加。
目次
- プロジェクト概要
- Proprietary vs Mantic(コスト分析)
- 特徴
- インストール方法
- 使用方法
- エージェントルール
- パフォーマンス
- 動作原理
- ライセンス
1. プロジェクト概要
Mantic は AI エージェントの不要なコンテキスト取得オーバーヘッドを排除するインフラ層です。
ファイル構造とメタデータから意図を推測し、内容を逐一読むことなく高速検索(人間の反応時間より速い)を実現します。
主なメリット
- 速度 – 大規模リポジトリでも 500 ms 以下で取得。
- 効率 – 関連性の低いファイルを事前フィルタリングすることで、トークン使用量を最大63%削減。
- プライバシー – 完全ローカル実行でデータ外部送信なし。
2. Proprietary vs Mantic(コスト分析)
| ツール | 年間費用 | 検索あたりの費用 | プライバシー |
|---|---|---|---|
| Mantic | $0 | $0 | ローカル優先 |
| ベクトル埋め込み | $10,950 | $0.003 | クラウド |
| SaaS 代替品 | $109,500 | $0.003 | クラウド |
100 名の開発者が1日あたり 100 回検索するケースを想定。
3. 特徴
- 大規模モノレポ(Chromium: 480k ファイル)でも 500 ms 未満で取得。
- 外部依存なし(API キーもデータベースも不要)。
- Git ネイティブファイルスキャン(トラッキング済みファイルを優先)。
- 決定論的スコアリング(結果は一貫して予測可能)。
- MCP 本体サポート(Claude Desktop、Cursor で動作)。
- 影響分析機能(変更の潜在的な波及範囲を特定)。
4. インストール方法
クイックスタート
# インストール不要で実行 npx mantic.sh@latest "検索クエリ"
ツール別インストール
ソースからビルド
git clone https://github.com/marcoaapfortes/Mantic.sh.git cd Mantic.sh npm install npm run build npm link
5. 使用方法
基本検索
mantic "stripe payment integration"
JSON を返し、ファイル順位・信頼度スコア・トークン推定値を含む。
CLI オプション
| オプション | 説明 |
|---|---|
| コードファイル (.ts, .js など) のみ検索 |
| 設定ファイルのみ検索 |
| テストファイルのみ検索 |
| JSON 出力(デフォルト) |
| ファイルパスを改行区切りで出力 |
| 依存関係分析を含める |
| セッション ID を使いコンテキスト継続 |
6. エージェントルール(Auto‑Pilot)
Cursor や Claude が自動で Mantic を利用するようにしたい場合は、以下のルールをコピーし、AI ツールのシステムプロンプトまたは「Rules for AI」セクションに貼り付けます。
これでコードを書く前に
mantic でコンテキスト検索が自動的に実行されます。
7. パフォーマンス
レイテンシベンチマーク(M1 Pro)
| コードベース | ファイル数 | サイズ | Mantic | ベクトル検索 | 改善率 |
|---|---|---|---|---|---|
| Cal.com | 9,621 | ~500 MB | 0.32 s | 0.85 s | 2.7×速い |
| Chromium | 480k | 59 GB | 0.46 s | 5‑10 s | 11‑22×速い |
8. 動作原理
アーキテクチャ概要
ユーザークエリ → 意図解析(UI/バックエンド/認証等) ↓ ブレインスコアラー(メタデータでファイル順位付け) ↓ ファイル分類器(コード/設定/テストでフィルタ) ↓ 影響分析器(波及範囲計算) ↓ 出力(JSON/ファイル/Markdown/MCP)
コアアルゴリズム
-
意図認識 – クエリからコードカテゴリを決定。
-
ファイル列挙 –
で追跡済みファイルのみ取得(標準走査より高速)。git ls-files -
構造スコアリング – 以下を重視して順位付け:
- パスの関連性(例:
)packages/features/payments - ファイル名一致度 (
>stripe.service.ts
)stripe.txt - ビジネスロジック感知 (.service.ts を .test.ts より高評価)
- ボイラープレートペナルティ(index.ts や page.tsx は低評価)
- パスの関連性(例:
-
信頼度スコア – 各結果に関連性スコアを割当。
設定
ほとんどのプロジェクトで設定不要ですが、必要に応じて環境変数で調整可能です。
export MANTIC_MAX_FILES=5000 # スキャン上限ファイル数 export MANTIC_TIMEOUT=5000 # 検索タイムアウト(ms) export MANTIC_IGNORE_PATTERNS="**/node_modules/**,**/.git/**"
9. ライセンス
Mantic は AGPL‑3.0 ライセンスの下で配布されています。
利用ガイドライン
- 無料利用対象:個人開発者、オープンソースプロジェクト、社内業務利用。
- ライセンスが必要なケース:販売製品への商用埋め込みや Mantic をホストサービスとして提供する場合。
*商用問い合わせは
license@mantic.sh まで。詳細は LICENSE ファイルをご覧ください。