agents-docs

Сверхбыстрый, без лишнего веса локальный RAG для документации в формате Markdown для ИИ-агентов кодинга через MCP.
Мгновенный поиск BM25 по официальной документации фреймворков и живым реестрам моделей ИИ. Общий для Cursor, Claude Code, Antigravity и Zed.

Зачем .agents/docs?

Кодинг-агенты часто галлюцинируют устаревшие API (Svelte 4 против 5 Runes, Tailwind v3 против v4, React 19 Actions) или ссылаются на устаревшие модели LLM и цены на токены.

Традиционные решения RAG на основе векторных эмбеддингов раздуты: они требуют Docker-контейнеров, сотен мегабайт зависимостей Python (Chroma, LangChain) и медленных вызовов API для эмбеддингов, которые разрывают блоки кода пополам.

agents-docs применяет философию Lolaplex:

• Ноль векторных БД: разбиение Markdown с учётом заголовков + чистый лексический ранжировщик BM25 на Python с бустом совпадения заголовков (+6.0) и бустом полной фразы (+10.0).

• Поиск менее чем за 10 мс: мгновенное извлечение прямо из обычных markdown-файлов на диске (~/.agents/docs/).

• Живой реестр моделей ИИ: отслеживаемые в реальном времени контекстные окна, бенчмарки и цены на токены ($/1M) для моделей Frontier и Open-Weights (Claude 5/4, GPT-5/o3/o4, Gemini 3.x, DeepSeek V4/R1, Qwen 2.5 Coder).

• Курируемый каталог из 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          │
 └─────────────────────────────┘ └─────────────────────────────┘

Быстрый старт

Установка в один шаг

pip install agents-docs && agents-docs init

Создаёт структуру ~/.agents/docs/, заполняет живой реестр ai-models, автоматически настраивает конфигурации MCP в ваших установленных IDE и регистрирует навыки ассистента.

[!TIP] 🤖 Установка через агента (без трения):
Просто скажите вашему кодинг-агенту: "Установи и настрой agents-docs для меня."
Агент установит пакет, запустит agents-docs init и автоматически получит свежую документацию, когда вы спросите о техническом стеке или ценах на модели.

Справочник CLI

Справочник инструментов MCP

Поддерживаемая экосистема

• Claude Code: привязка через MCP-сервер и .agents/skills/docs-search.

• Google Antigravity: интеграция через правила .gemini/config и MCP agents-docs.

• Cursor: автоматически настраивает .cursor/mcp.json и правила агента.

• Zed: настраивает context_servers и зеркалирует навыки ассистента.

• VS Code / Windsurf: автоматически подключает конфигурацию MCP для Cline / Roo-Code.

Открытая спецификация ABI

Подробные архитектурные спецификации находятся в abi/:

• abi/WHY.md — Архитектурное обоснование и сравнение BM25 с векторными эмбеддингами.

• abi/LAYOUT.md — Таксономия хранения в ~/.agents/docs/.

• abi/MCP.md — Определения и схемы поверхности инструментов.

• abi/CATALOG.md — Схема курируемого каталога и поддерживаемые типы.

• abi/LLMSTXT.md — Поддержка стандарта llms.txt.

Тестирование и проверка

Запустите набор тестов на всех движках:

python tests/run_all_tests.py

Лицензия

Лицензия MIT. Подробности см. в LICENSE.