agents-docs

Ultra-schnelles, schlankes lokales Markdown-Dokumentations-RAG für KI-Coding-Agenten über MCP.
Sofortige BM25-Suche über offizielle Framework-Dokumentationen und Live-KI-Modellregister. Gemeinsam genutzt in Cursor, Claude Code, Antigravity und Zed.

Warum .agents/docs?

Coding-Agenten halluzinieren häufig veraltete APIs (Svelte 4 vs. 5 Runes, Tailwind v3 vs. v4, React 19 Actions) oder referenzieren veraltete LLM-Modelle und Token-Preise.

Traditionelle Vektor-Embedding-RAG-Lösungen sind aufgebläht: Sie erfordern Docker-Container, hunderte Megabyte an Python-Abhängigkeiten (Chroma, LangChain) und langsame API-Embedding-Aufrufe, die Codeblöcke in der Mitte zerreißen.

agents-docs wendet die Lolaplex-Philosophie an:

• Null Vektor-Datenbanken: Header-bewusstes Markdown-Chunking + reines Python-lexikalisches BM25-Ranking mit Header-Match-Boost (+6.0) und Voll-Phrasen-Boost (+10.0).

• Unter-10-ms-Suche: Sofortiger Abruf direkt aus einfachen Markdown-Dateien auf der Festplatte (~/.agents/docs/).

• Live-KI-Modellregister: Echtzeit-verfolgte Kontextfenster, Benchmarks und Token-Preise ($/1M) für Frontier- und Open-Weights-Modelle (Claude 5/4, GPT-5/o3/o4, Gemini 3.x, DeepSeek V4/R1, Qwen 2.5 Coder).

• Kuratierter Katalog mit 21+ Frameworks: 1-Klick-Sync für offizielle 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).

• Deterministisches Rausch-Pruning: Entfernt automatisch HTML-Hüllen, Link-Rauschen und Cookie-Banner, ohne Codeblöcke oder Tabellen zu verändern.

• Universeller MCP-Server: FastMCP-stdio-Schnittstelle mit Auto-Sync und Abhängigkeits-Manifest-Inspektion.

Related MCP server: Speakeasy Docs MCP

Architektur & Ablauf

 ┌─────────────────────────────────────────────────────────────┐
 │                  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          │
 └─────────────────────────────┘ └─────────────────────────────┘

Schnellstart

1-Schritt-Einrichtung

pip install agents-docs && agents-docs init

Erstellt ~/.agents/docs/, befüllt das Live-ai-models-Register, verdrahtet automatisch MCP-Konfigurationen in deine installierten IDEs und registriert Assistenten-Skills.

[!TIP] 🤖 Agenten-gesteuerte Einrichtung (Null Reibung):
Sage einfach deinem Coding-Agenten: „Installiere und richte agents-docs für mich ein."
Der Agent installiert das Paket, führt agents-docs init aus und ruft automatisch frische Dokumentation ab, wann immer du Fragen zu technischen Stacks oder Modellpreisen hast.

CLI-Referenz

MCP-Tools-Referenz

Unterstütztes Ökosystem

• Claude Code: Gebunden über MCP-Server und .agents/skills/docs-search.

• Google Antigravity: Integriert über .gemini/config-Regeln und agents-docs MCP.

• Cursor: Konfiguriert automatisch .cursor/mcp.json und Agenten-Regeln.

• Zed: Konfiguriert context_servers und spiegelt Assistenten-Skills.

• VS Code / Windsurf: Verdrahtet automatisch Cline / Roo-Code MCP-Konfiguration.

Offene ABI-Spezifikation

Detaillierte Architektur-Spezifikationen liegen in abi/:

• abi/WHY.md — Architektonische Begründung & BM25 vs. Vektor-Embeddings.

• abi/LAYOUT.md — Speicher-Taxonomie in ~/.agents/docs/.

• abi/MCP.md — Tool-Oberflächen-Definitionen und Schemas.

• abi/CATALOG.md — Kuratierte Katalog-Schemas und unterstützte Typen.

• abi/LLMSTXT.md — Unterstützung für den llms.txt-Standard.

Tests & Verifizierung

Führe die Test-Suite über alle Engines aus:

python tests/run_all_tests.py

Lizenz

MIT-Lizenz. Siehe LICENSE für Details.