agents-docs

AIコーディングエージェント向けの超高速・ゼロブロートなローカルMarkdownドキュメントRAG（MCP経由）。
公式フレームワークドキュメントとライブAIモデルレジストリに対するインスタントBM25検索。Cursor、Claude Code、Antigravity、Zedで共有可能。

.agents/docs が必要な理由

コーディングエージェントは、非推奨のAPI（Svelte 4 vs 5 Runes、Tailwind v3 vs v4、React 19 Actions）を幻覚したり、古いLLMモデルやトークン価格を参照したりすることがよくあります。

従来のベクター埋め込みRAGソリューションは肥大化しています。Dockerコンテナ、数百メガバイトのPython依存関係（Chroma、LangChain）、そしてコードブロックを半分に分割する遅いAPI埋め込み呼び出しが必要です。

agents-docs はLolaplexの哲学を適用します：

• ベクターDB不要：ヘッダー対応Markdownチャンキング＋純Pythonの語彙BM25ランキング（ヘッダーマッチブースト+6.0、完全フレーズブースト+10.0）。

• 10ms未満の検索：ディスク上のプレーンなMarkdownファイル（~/.agents/docs/）から直接インスタント取得。

• ライブAIモデルレジストリ：フロンティアモデルとオープンウェイトモデル（Claude 5/4、GPT-5/o3/o4、Gemini 3.x、DeepSeek V4/R1、Qwen 2.5 Coder）のリアルタイム追跡されたコンテキストウィンドウ、ベンチマーク、トークン価格（$1Mあたり）。

• キュレーション済み21以上のフレームワークカタログ：公式llms.txtのワンクリック同期（TypeScript Handbook、Svelte 5、FastAPI、Tailwind v3/v4、Tauri 2、Next.js、Supabase、Hono、WXT、Netlify、Coolify、Cloudflare、Resend、React、Vite、Zod、Pydantic、shadcn/ui）。

• 決定的ノイズ除去：コードブロックやテーブルを変更せずに、HTMLラッパー、リンクノイズ、Cookieバナーを自動的に除去。

• ユニバーサルMCPサーバー：自動同期と依存関係マニフェスト検査を備えたFastMCP stdioインターフェース。

Related MCP server: Speakeasy Docs MCP

アーキテクチャとフロー

 ┌─────────────────────────────────────────────────────────────┐
 │                  DOCS & MODEL REGISTRIES                    │
 │    Official llms.txt · TypeScript Handbook · OpenRouter     │
 └──────────────────────────────┬──────────────────────────────┘
                                │  agents-docs sync <name>
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                 DETERMINISTIC NOISE PRUNER                  │
 │    Strips HTML boilerplate while preserving 100% of code    │
 └──────────────────────────────┬──────────────────────────────┘
                                │  Header-aware chunking
                                ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                   LOCAL DOCUMENTATION STORE                 │
 │   ~/.agents/docs/ai-models/       ~/.agents/docs/svelte-5/  │
 │   ~/.agents/docs/typescript/      ~/.agents/docs/fastapi/   │
 └──────────────┬───────────────────────────────┬──────────────┘
                │                               │
                ▼                               ▼
 ┌─────────────────────────────┐ ┌─────────────────────────────┐
 │        LEXICAL BM25         │ │     MCP SERVER & CLERK      │
 │  Header Match Boost (+6.0)  │ │  search_docs · list_docsets │
 │  Sub-10ms Exact Retrieval   │ │  sync_project_docs          │
 └─────────────────────────────┘ └─────────────────────────────┘

クイックスタート

1ステップセットアップ

pip install agents-docs && agents-docs init

~/.agents/docs/をスキャフォールドし、ライブai-modelsレジストリをシードし、インストール済みIDEにMCP設定を自動配線し、アシスタントスキルを登録します。

[!TIP] 🤖 エージェント駆動セットアップ（ゼロフリクション）：
コーディングエージェントにこう伝えるだけです：「agents-docsをインストールしてセットアップして」
エージェントがパッケージをインストールし、agents-docs initを実行し、技術スタックやモデル価格の質問をするたびに自動的に最新のドキュメントを取得します。

CLIリファレンス

MCPツールリファレンス

対応エコシステム

• Claude Code： MCPサーバーと.agents/skills/docs-searchを介してバインド。

• Google Antigravity： .gemini/configルールとagents-docs MCPを介して統合。

• Cursor： .cursor/mcp.jsonとエージェントルールを自動設定。

• Zed： context_serversを設定し、アシスタントスキルをミラーリング。

• VS Code / Windsurf： Cline / Roo-Code MCP設定を自動配線。

オープンABI仕様

詳細なアーキテクチャ仕様はabi/にあります：

• abi/WHY.md — アーキテクチャの根拠とBM25 vs ベクター埋め込み。

• abi/LAYOUT.md — ~/.agents/docs/内のストレージ分類。

• abi/MCP.md — ツールサーフェスの定義とスキーマ。

• abi/CATALOG.md — キュレーション済みカタログスキーマとサポートされるタイプ。

• abi/LLMSTXT.md — llms.txt標準のサポート。

テストと検証

全エンジンでテストスイートを実行：

python tests/run_all_tests.py

ライセンス

MITライセンス。詳細はLICENSEを参照してください。