agents-docs

Documentación RAG de markdown local, ultrarrápida y sin inflado, para agentes de IA mediante MCP.
Búsqueda BM25 instantánea sobre documentación oficial de frameworks y registros de modelos de IA en vivo. Compartida entre Cursor, Claude Code, Antigravity y Zed.

¿Por qué .agents/docs?

Los agentes de codificación alucinan con frecuencia con APIs obsoletas (Svelte 4 vs 5 Runes, Tailwind v3 vs v4, React 19 Actions) o hacen referencia a modelos de LLM y precios de tokens desactualizados.

Las soluciones tradicionales de RAG con vectores de incrustación son infladas: requieren contenedores Docker, cientos de megabytes de dependencias de Python (Chroma, LangChain) y llamadas de API de incrustación lentas que dividen los bloques de código por la mitad.

agents-docs aplica la filosofía Lolaplex:

• Cero bases de datos vectoriales: Fragmentación de markdown consciente de encabezados + clasificación léxica BM25 pura en Python con coincidencia de encabezado (+6.0) y frase completa (+10.0).

• Búsqueda en menos de 10 ms: Recuperación instantánea directamente desde archivos markdown en disco (~/.agents/docs/).

• Registro de modelos de IA en vivo: Ventanas de contexto, puntos de referencia y precios de token ($/M) en tiempo real para modelos Frontier y de pesos abiertos (Claude 5/4, GPT-5/o3/o4, Gemini 3.x, DeepSeek V4/R1, Qwen 2.5 Coder).

• Catálogo seleccionado de 21+ frameworks: Sincronización con 1 clic para llms.txt oficial (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).

• Poda de ruido determinista: Elimina automáticamente envoltorios HTML, ruido de enlaces y pancartas de cookies sin alterar bloques de código ni tablas.

• Servidor MCP universal: Interfaz FastMCP stdio con sincronización automática e inspección de manifiestos de dependencias.

Related MCP server: Speakeasy Docs MCP

Arquitectura y flujo

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

Inicio rápido

Configuración en 1 paso

pip install agents-docs && agents-docs init

Crea ~/.agents/docs/, siembra el registro de ai-models en vivo, conecta automáticamente las configuraciones de MCP en tus IDE instalados y registra habilidades de asistente.

[!SUGERENCIA] 🤖 Configuración impulsada por agentes (Cero fricción):
Simplemente dile a tu agente de codificación: "Instala y configura agents-docs para mí."
El agente instala el paquete, ejecuta agents-docs init y recupera automáticamente la documentación fresca siempre que hagas preguntas sobre el stack técnico o los precios de los modelos.

Referencia de la CLI

Referencia de herramientas MCP

Ecosistema compatible

• Claude Code: Vinculado mediante el servidor MCP y .agents/skills/docs-search.

• Google Antigravity: Integrado mediante .gemini/config y el MCP de agents-docs.

• Cursor: Configura automáticamente .cursor/mcp.json y las reglas del agente.

• Zed: Configura context_servers y refleja las habilidades del asistente.

• VS Code / Windsurf: Cableado automático de la configuración de Cline / Roo-Code MCP.

Especificación abierta

Las especificaciones arquitectónicas detalladas viven en abi/:

• abi/WHY.md — Justificación arquitectónica y BM25 frente a vectores de incrustación.

• abi/LAYOUT.md — Taxonomía de almacenamiento en ~/.agents/docs/.

• abi/MCP.md — Definiciones y esquemas de la superficie de herramientas.

• abi/CATALOG.md — Esquema del catálogo seleccionado y tipos admitidos.

• abi/LLMSTXT.md — Soporte para el estándar llms.txt.

Pruebas y verificación

Ejecuta la suite de pruebas en todos los motores:

python tests/run_all_tests.py

Licencia

Licencia MIT. Consulta LICENCIA para más detalles.