Moxie Docs

Actualizaciones automáticas de documentación desde agentes y convenciones del código base para reducir el uso de tokens.

Ver en moxiedocs.comPrueba este MCPPatrocinado

Documentación

Moxie Docs

Gratis para empezar con un repositorio, sin necesidad de tarjeta. Comprobaciones de PR que detectan vacíos en la documentación, documentación viva que se revisa en cada merge, contexto MCP para agentes de IA, bases de conocimiento públicas alojadas y PRs de Limpieza de Viernes desde GitHub.

Moxie Docs es un servicio alojado que se conecta a tus repositorios de GitHub, mantiene una base de conocimiento buscable de tu código en sincronía en cada merge, y sirve ese contexto a agentes de IA de codificación a través de MCP. Creado por jackalope.digital.

Producto

  • Descripción general: Documentación automatizada de código para GitHub: documentación buscable, contexto MCP y PRs de Limpieza de Viernes.
  • Cómo funciona: Indexación, generación de documentación, detección de desviaciones y PRs de Limpieza de Viernes.
  • Casos de uso: Incorporación, documentación de arquitectura y contexto para agentes de IA.
  • Servidor MCP: Cómo los agentes de IA consultan el contexto de tu código a través del Protocolo de Contexto de Modelos.
  • Documentación de código automatizada: Genera documentación de código buscable desde GitHub automáticamente. Arquitectura, convenciones, flujos entre archivos, detección de desviaciones, contexto MCP y PRs de Limpieza de Viernes.
  • Detección de desviaciones en la documentación: Detecta desviaciones en la documentación y corrige documentación obsoleta en cada merge. Superficie de vacíos y abre un PR de Limpieza de Viernes revisable para que la wiki no se deteriore silenciosamente.
  • Centro de herramientas gratuitas: Diagramas ER de SQL en el navegador, utilidades de README, Mermaid, ADR, AGENTS.md y llms.txt: sin necesidad de cuenta.
  • Código abierto: Cómo Moxie Docs apoya y trabaja con repositorios de código abierto.

Integraciones de agentes

Conecta el contexto MCP de Moxie Docs a los agentes que tu equipo ya usa:

  • Cursor: Conecta Cursor a la documentación viva, convenciones y vacíos de documentación de tu repositorio a través de MCP. Un comando de configuración después de conectar GitHub: sin empaquetado manual de contexto.
  • Claude Code: Dale a Claude Code convenciones de repositorio, documentación generada y vacíos de documentación a través de MCP, y mantén AGENTS.md y CLAUDE.md alineados con el código que se publica.
  • Codex: Conecta OpenAI Codex a documentación y convenciones de código en vivo a través de MCP. Contexto compacto de Moxie Docs para menos lecturas exploratorias y mejores ediciones.
  • Windsurf: Conecta Windsurf a Moxie Docs a través de MCP para documentación de código en vivo, convenciones y vacíos de documentación. Un comando de configuración después de conectar GitHub.
  • Cline y Roo Code: Conecta Cline y Roo Code a la documentación de código en vivo, convenciones y vacíos de documentación de tu repositorio a través de MCP. Cero empaquetado manual de contexto.
  • GitHub Copilot: Dale al Modo Agente de GitHub Copilot convenciones de repositorio en vivo y vacíos de documentación a través de MCP, y mantén .github/copilot-instructions.md actualizado.

Soluciones

Cómo Moxie Docs se adapta a cada rol de ingeniería y configuración organizacional:

Lo que dicen los desarrolladores

Citas del lanzamiento en Product Hunt y otras reseñas:

  • Zaid Mallik: "La calidad del contexto parece estar convirtiéndose en un cuello de botella mayor que la calidad del modelo para muchos flujos de trabajo de agentes." (@zaidmallik · Product Hunt)
  • GlyphHarbor: "La documentación que viaja al asistente de codificación es la parte que se siente correcta aquí. Un README en GitHub es útil, pero en el momento en que estoy en un bucle de Claude/Codex, la pregunta es si la regla actual está realmente frente al modelo." (@glyphharbor · Product Hunt)
  • MakerStack: "Moxie Docs aborda el problema real de la documentación obsoleta generando documentación automáticamente y señalando desviaciones en el merge, lo cual es inteligente." (Reseña de producto · MakerStack)
  • Paul Crinigan: "La comprobación de PR es la parte con la que lideraría. La documentación se deteriora porque nada en el flujo de trabajo te dice que se deterioró, así que una comprobación que falla ruidosamente en el diff vale más que cualquier cantidad de calidad de generación." (@paul_crinigan · Product Hunt)
  • Grace Lee: "Esto se siente útil porque la documentación está empezando a servir a dos audiencias a la vez: humanos que leen la base de conocimiento pública y agentes de IA que usan el contexto del repositorio mientras se trabaja." (@grace_lee26 · Product Hunt)
  • Adrian Ciaschetti: "La idea de Limpieza de Viernes está bien contenida. Agrupar la desviación de documentación en un solo PR revisable, sin auto-merge, se siente como un hábito mucho más fácil de confiar para un equipo." (@adriancia · Product Hunt)

Precios

Tres planes, cada uno con prueba gratuita de 14 días. Cada plan puede facturarse mensual o anualmente; la facturación anual equivale a dos meses gratis (aproximadamente 17% de descuento):

  • Gratis - $0/mes o $0/año: Véalo funcionar en un repositorio real antes de decidir nada. Sin necesidad de tarjeta. Hasta 1 repositorio, 1 asiento.
  • Starter - $29/mes o $290/año: Para constructores individuales que documentan un puñado de repositorios privados. Hasta 5 repositorios, 1 asiento.
  • Pro - $79/mes o $790/año: Documentación sin intervención para un equipo en crecimiento: Resúmenes semanales, PRs de Limpieza automatizados y espacio para muchos repositorios. Hasta 15 repositorios, 10 asientos.
  • Team - $199/mes o $1,990/año: Para organizaciones con una flota de servicios: asientos ilimitados, indexación prioritaria y la mayor capacidad. Hasta 50 repositorios, asientos ilimitados.

Especificaciones del producto

Implementación: SaaS alojado. Se conecta a GitHub a través de una GitHub App con alcance limitado y privilegios mínimos, con acceso de solo lectura al repositorio; Moxie Docs nunca hace commits a tu código y nunca fusiona nada: la documentación llega solo como solicitudes de extracción revisables.

Punto final MCP: Un servidor de Protocolo de Contexto de Modelos en https://moxiedocs.com/api/mcp sirve convenciones, documentación, vacíos de documentación y comandos verificados a agentes de IA de codificación como Cursor, Claude Code, Codex y otros clientes compatibles con MCP, para que los agentes hagan una búsqueda con alcance en lugar de volver a rastrear el repositorio en cada prompt.

Niveles de precios: Gratis $0/mes, Starter $29/mes, Pro $79/mes, Team $199/mes. Cada plan incluye una prueba gratuita de 14 días y se cobra por repositorio, no por asiento; la facturación anual equivale a aproximadamente dos meses gratis.

Capacidades principales: Documentación de código automatizada, detección de desviaciones de documentación en cada merge, PRs semanales de Limpieza de Viernes, búsqueda interactiva de código, contexto MCP para agentes de IA de codificación y bases de conocimiento públicas alojadas.

Recursos para desarrolladores

Comparaciones

  • Descripción general de comparaciones: Todas las páginas de comparación de un vistazo.
  • Moxie Docs vs Mintlify: Contexto de código vs. agente de sitio de documentación: Moxie Docs mapea tu arquitectura y la sirve a agentes de codificación a través de MCP; el agente de IA de Mintlify redacta actualizaciones para tu sitio de documentación.
  • Moxie Docs vs Jamdesk: Generación vs. publicación: Moxie Docs escribe y mantiene documentación desde tu código; Jamdesk aloja el MDX que tú mismo redactas, con precios planos y chat de IA orientado al lector.
  • Moxie Docs vs Context7: Tu código vs. documentación de bibliotecas públicas: Moxie genera y mantiene documentación para tu propio repositorio y la sirve a través de MCP; Context7 inyecta documentación actualizada de bibliotecas de terceros en tus prompts.
  • Moxie Docs vs Swimm: Autogestionado vs. liderado por ventas: wikis de código con mantenimiento cero a partir de análisis continuo del repositorio, sin necesidad de llamada de descubrimiento para ver precios o comenzar.
  • Moxie Docs vs Docusaurus: Generación vs. publicación: Moxie escribe y mantiene documentación desde tu fuente y la sirve a agentes a través de MCP; Docusaurus es un generador de sitios estáticos de código abierto para documentación que tú escribes y alojas.
  • Moxie Docs vs GitBook: Nativo de código vs. wiki multifuncional: documentación acoplada al código y generada por IA sin la licencia de wiki por asiento de GitBook.
  • Moxie Docs vs Google Code Wiki: Repositorios privados vs. vista previa pública: Moxie Docs documenta tu código privado y abre solicitudes de extracción; Google Code Wiki es una wiki gratuita de solo lectura para repositorios públicos.
  • Moxie Docs vs Confluence: Sincronización automatizada de código vs. cementerio de texto heredado: la documentación permanece acoplada al código en lugar de desviarse y quedar obsoleta.
  • Moxie Docs vs Repowise: GitHub App alojada vs. demonio autoalojado: Moxie Docs abre solicitudes de extracción solo de documentación sin nada que instalar, en lugar de ejecutar tu propio demonio de indexación.
  • Moxie Docs vs Merge.dev: MCP nativo de código vs. API de integraciones unificadas: servidores MCP sin código que sirven contexto de repositorio a agentes.
  • Moxie Docs vs Cursor Rules: Generado vs. escrito a mano: Moxie Docs sirve convenciones de repositorio a través de MCP que se actualizan solas desde tu código, en lugar de archivos de reglas que alguien tiene que escribir y mantener manualmente.
  • Moxie Docs vs DocuWriter.ai: Solicitudes de extracción solo de documentación vs. un Espacio de documentación: ambos generan documentación de todo el repositorio y un servidor MCP, pero Moxie Docs enruta las actualizaciones a través de solicitudes de extracción de GitHub y añade un sitio de base de conocimiento pública.

Comparaciones directas entre herramientas de documentación:

  • Mintlify vs GitBook: Flujo de trabajo MDX para desarrolladores vs. un editor de bloques para equipos mixtos.
  • GitBook vs Confluence: Plataforma de documentación diseñada para el propósito vs. la wiki empresarial general.
  • Mintlify vs Confluence: Documentación MDX acoplada al código vs. una wiki empresarial desacoplada.
  • Mintlify vs Docusaurus: Plataforma MDX gestionada vs. generador de sitios estáticos gratuito de código abierto.
  • GitBook vs Docusaurus: Editor de bloques para equipos mixtos vs. sitios Markdown autoalojados.
  • Mintlify vs Swimm: Alojamiento pulido de documentación pública vs. recorridos de incorporación anclados al código.
  • Mintlify vs Jamdesk: Plataforma de documentación premium con un Agente de IA vs. alojamiento MDX de precio plano.

Aprende

Guías sobre MCP, documentación y prácticas de desarrollo con IA:

Recursos

  • Blog: Artículos sobre documentación, bases de código y herramientas de desarrollo con IA. Fuente RSS completa en /blog/feed.xml.
  • Archivo de contexto completo: Guías integradas, resúmenes de herramientas y preguntas frecuentes para la ingesta de IA.
  • Preguntas frecuentes: Respuestas sobre generación de documentación, acceso y seguridad de GitHub, contexto MCP, lenguajes compatibles y precios.
  • Seguridad: Cómo maneja Moxie Docs los datos de repositorios y el acceso.
  • Contacto: Ponte en contacto con el equipo.

Preguntas frecuentes

¿Qué es Moxie Docs?

Un servicio alojado que se conecta a GitHub, genera documentación de bases de código buscable a partir del código fuente, la mantiene actualizada en cada fusión y sirve ese contexto a los agentes de IA a través de MCP. Las actualizaciones de documentación llegan como solicitudes de extracción que tu equipo revisa.

¿Qué sucede después de que conecto un repositorio?

Moxie ejecuta un primer índice completo, genera documentación y convenciones, y luego vuelve a indexar en cada fusión. Las comprobaciones de solicitudes de extracción para la alineación de descripciones, las brechas de documentación y las convenciones comienzan con las siguientes solicitudes de extracción.

¿Las comprobaciones de solicitudes de extracción bloquean la fusión o solo advierten?

Por defecto, advierten. Moxie publica ejecuciones de comprobación de GitHub (Moxie Docs / Descripción, Moxie Docs / Documentación, Moxie Docs / Convenciones) con conclusiones informativas sobre los hallazgos; no hacen fallar la comprobación y no bloquean la fusión por sí solas. Para convertirlas en un requisito estricto, exige esos nombres de comprobación en las reglas de protección de ramas de tu repositorio.

¿Moxie cambiará mi código automáticamente?

No. Las actualizaciones de documentación son solicitudes de extracción revisables que solo contienen documentación. La alineación de descripciones solo edita el texto de la descripción de la solicitud de extracción. El control de la fusión permanece en tu equipo.

¿Cómo reduce MCP el costo de los agentes?

Los agentes obtienen convenciones, documentación, brechas y comandos verificados en lugar de volver a rastrear el repositorio en cada prompt: menos tokens y menos suposiciones incorrectas. Cuando el código no está documentado, MCP expone la brecha en lugar de inventar APIs.

¿Puedo publicar un centro de ayuda público para mis usuarios?

Sí: la Base de Conocimientos Pública (Beta) convierte tu repositorio en un sitio de ayuda alojado en tu-equipo.moxiedocs.app, escrito para usuarios finales, desarrolladores o ambos. Cada página es aprobada por humanos antes de publicarse; las notas internas de los agentes permanecen fuera del sitio público hasta que las publiques. Disponible en todos los planes durante la beta.

¿La indexación es única o continua?

Continua. El primer índice construye la línea base. Cada fusión vuelve a comprobar la documentación afectada, señala desviaciones y brechas, y mantiene el contexto MCP actualizado. En los planes Pro y Team, la Limpieza de Viernes agrupa las correcciones restantes en una sola solicitud de extracción de solo documentación que revisas y fusionas; nada se fusiona automáticamente.

¿Cuánto cuesta?

Gratis para siempre para un repositorio, sin necesidad de tarjeta. Más allá de eso, Starter cuesta $29/mes, Pro $79/mes y Team $199/mes, cada uno con una prueba gratuita de 14 días. La facturación anual ahorra aproximadamente dos meses. Los equipos de un solo repositorio con poca rotación suelen preferir Starter anual o el pase de prueba único de $5 en /pricing.

¿Moxie Docs funciona con repositorios privados de GitHub?

Sí. Está diseñado para repositorios privados. La aplicación de GitHub tiene un alcance limitado solo a los repositorios que elijas, los tokens están cifrados en el servidor y el código se usa únicamente para generar documentación y contexto MCP para tu espacio de trabajo.

¿Qué lenguajes de programación admite Moxie Docs?

La documentación y la búsqueda funcionan con cualquier repositorio de GitHub. Moxie reconoce lenguajes principales como TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, PHP, SQL, Svelte, Vue, Kotlin, Swift, Elixir y Zig, con el análisis de convenciones estructuradas más profundo (gráficos de símbolos e importaciones) para TypeScript/JavaScript y Python.

¿Cómo mantengo la documentación sincronizada con mi código?

Conecta un repositorio de GitHub. Moxie vuelve a indexar en cada fusión, señala las páginas afectadas por los cambios de código, regenera la documentación obsoleta con diferencias citadas y, en los planes Pro y Team, ejecuta la Limpieza de Viernes para abrir solicitudes de extracción semanales de solo documentación para revisión.

¿Cuánto cuesta la documentación automatizada de bases de código?

Starter cuesta $29/mes, Pro $79/mes y Team $199/mes, cada uno con una prueba gratuita de 14 días. La facturación anual ahorra aproximadamente dos meses en comparación con la mensual. No existe un SKU de pago por uso hoy; Starter anual es la mejor opción para un solo repositorio con poca rotación.

¿Cuál es la mejor herramienta para la documentación automatizada de bases de código en GitHub?

Moxie Docs indexa los repositorios que selecciones a través de una aplicación de GitHub con alcance limitado, genera documentación de arquitectura y convenciones basada en el código fuente, detecta desviaciones de documentación en cada fusión y abre solicitudes de extracción semanales de Limpieza de Viernes para que la documentación se mantenga actualizada sin reescrituras manuales. También expone un servidor MCP para que Cursor, Claude Code y Codex obtengan convenciones verificadas en lugar de volver a rastrear el repositorio.

¿Qué es la desviación de documentación y cómo la detecta Moxie Docs?

La desviación de documentación ocurre cuando la documentación escrita ya no coincide con el código que describe. Moxie Docs comprueba cada solicitud de extracción fusionada contra la documentación que toca, compara la documentación generada con el código fuente actual, expone las brechas en el espacio de trabajo y regenera las páginas afectadas para que los equipos vean qué cambió y por qué.

¿Qué es la Limpieza de Viernes en Moxie Docs?

La Limpieza de Viernes es una automatización semanal de solo documentación en los planes Pro y Team. Moxie agrupa pequeñas correcciones de documentación (páginas obsoletas, brechas y desviaciones) en una sola solicitud de extracción que tu equipo puede revisar con el café del viernes. Nada se fusiona automáticamente; tú tienes el botón de fusión.

¿Cómo obtienen contexto de la base de código los agentes de programación con IA de Moxie Docs?

Cada plan de Moxie Docs incluye un servidor MCP (Protocolo de Contexto de Modelos). Los agentes y editores compatibles lo consultan para obtener documentación actual, convenciones, comandos verificados y brechas abiertas, en lugar de adivinar a partir de lecturas parciales de archivos, lo que reduce el desperdicio de tokens y las suposiciones incorrectas sobre APIs.

¿Qué es un servidor MCP para bases de código?

Un servidor MCP para bases de código expone la documentación y las convenciones del repositorio a los agentes de IA a través del Protocolo de Contexto de Modelos. Moxie Docs publica uno en /api/mcp con acceso OAuth y token de portador para que los agentes obtengan contexto en vivo y citado sobre cómo funciona realmente tu proyecto.

¿Qué sucede cuando un agente encuentra código no documentado a través de MCP?

Las herramientas MCP devuelven brechas e impacto estructurados, no APIs inventadas. Los agentes pueden llamar a moxie.get_doc_gaps, moxie.get_doc_impact y moxie.propose_doc_update para que la documentación faltante llegue en la misma solicitud de extracción que el cambio de código, o esperar a la Limpieza de Viernes, en lugar de tapar el agujero.

¿Qué pasa si la documentación es correcta y el código está mal?

La detección de desviaciones trata la base de código actual como la señal principal de lo que se envió. Moxie nunca reescribe automáticamente el código de la aplicación ni sobrescribe silenciosamente la intención escrita a mano. Las solicitudes de extracción de solo documentación siguen siendo revisables; si una fusión incorrecta rompió el código, rechaza el cambio de documentación y corrige el código. Los RFC prospectivos no se tratan como obsoletos solo porque citan rutas que aún no se han construido.

¿Cómo maneja Moxie los RFC y documentos de diseño antes del código?

Los documentos escritos a mano y prospectivos están protegidos contra la obsolescencia falsa de "eliminar esto". Las citas que nunca existieron en un índice anterior se rastrean como no construidas, no como eliminaciones. Cuando esas referencias comienzan a resolverse en código real, Moxie genera una señal informativa de "listo para verificar" para los humanos; no fusiona ni reescribe automáticamente el RFC. Los documentos escritos a mano obsoletos pero aún válidos se pueden actualizar mediante solicitudes de extracción revisables.

¿Pueden filtrarse notas internas en la base de conocimientos pública?

Ninguna página se hace pública sin un paso de publicación humano. La bandeja de revisión de la Base de Conocimientos Pública mantiene los borradores privados; los documentos del espacio de trabajo orientados a agentes y las notas temporales de implementación no están en el sitio público. Los controles de calidad señalan jerga interna y frases propensas a filtraciones antes de publicar. Tú eliges la audiencia (usuarios, desarrolladores o ambos) en la configuración.

¿Cómo funciona la indexación en monorepos grandes con confirmaciones frecuentes?

El primer índice es una línea base completa y tarda más en árboles grandes. Después, las fusiones vuelven a comprobar la superficie afectada de forma incremental, por lo que cada confirmación no es una reconstrucción completa. Usa rutas ignoradas en la configuración de documentación del repositorio para omitir carpetas generadas, dependencias de proveedores y ruido. Los planes Team obtienen indexación prioritaria para flotas más grandes.

¿Cómo hago que las comprobaciones de solicitudes de extracción de Moxie Docs sean obligatorias antes de fusionar?

En la protección de ramas de GitHub (o conjuntos de reglas), exige comprobaciones de estado y selecciona Moxie Docs / Descripción, Moxie Docs / Documentación y/o Moxie Docs / Convenciones. Hasta que lo hagas, Moxie publica ejecuciones de comprobación informativas para que los hallazgos sigan siendo visibles sin bloquear al equipo por defecto.

¿Cómo ayuda Moxie Docs a incorporar nuevos ingenieros?

Moxie genera resúmenes de arquitectura buscables, recorridos de módulos y guías de convenciones citadas a archivos fuente, y luego las mantiene actualizadas en cada fusión. Los nuevos ingenieros buscan en un solo espacio de trabajo en lugar de explorar el repositorio, y los agentes de IA que usan heredan el mismo contexto fundamentado a través de MCP.

¿Puede Moxie Docs generar documentación de arquitectura a partir del código fuente?

Sí. Moxie indexa tu repositorio, construye un esquema de módulos y dependencias, y genera páginas de arquitectura, referencias y resúmenes de convenciones con citas a los archivos de los que provienen. Las páginas se regeneran de forma incremental cuando el código subyacente cambia.

¿Qué es una base de conocimientos alojada?

Una base de conocimientos alojada es un sitio de ayuda buscable fundamentado en tu base de código, escrito para los usuarios finales de tu producto, para los desarrolladores que integran tu API, o ambos, según la audiencia que elijas durante la configuración. Moxie Docs la publica en un subdominio de moxiedocs.app (los dominios personalizados llegarán pronto en los planes Pro y Team) con revisión humana antes de que algo se haga público, búsqueda de artículos integrada y contenido que permanece en tu repositorio de git como Markdown.

¿Puede Moxie Docs alojar un centro de ayuda para usuarios finales?

Sí. Elige la audiencia "Usuario" durante la configuración de la base de conocimientos y Moxie escribe artículos de ayuda en lenguaje sencillo sobre cómo usar tu producto, sin identificadores de código ni jerga interna, revisados por ti antes de publicar cualquier cosa. Elige "Ambos" para servir a usuarios finales y desarrolladores desde el mismo sitio.

¿Moxie Docs cambiará mi código de aplicación automáticamente?

No. Moxie solo propone cambios de documentación como solicitudes de extracción revisables. La alineación de descripciones puede actualizar la descripción de una solicitud de extracción en GitHub, pero tu código fuente, la protección de ramas y los controles de fusión permanecen en tu equipo.

Herramientas

  • Centro de herramientas gratuitas: Todas las utilidades de documentación basadas en navegador en un solo lugar.
  • Editor de diagramas Mermaid: Editor privado en el navegador con vista previa instantánea, URLs compartibles y exportación SVG.
  • SQL a diagrama ER: Pega SQL de CREATE TABLE para un diagrama ER de Mermaid en vivo, exportación SVG/PNG y documentación opcional de modelos de datos con IA.
  • Generador de README: Constructor estructurado de README con vista previa de Markdown en vivo y exportación compartible.
  • Generador de llms.txt: Importa un sitemap, edita con vista previa en vivo y exporta un llms.txt válido para agentes de IA.
  • Generador de AGENTS.md: Constructor estructurado de AGENTS.md con vista previa en vivo, ejemplos y exportación compartible para agentes de codificación.
  • Generador de ADR: Registros de decisiones de arquitectura basados en formularios con ejemplos y exportación limpia en Markdown.
  • Validador de llms.txt: Pega o sube llms.txt para validar estructura, enlaces y la colocación de la sección opcional.
  • Generador de .cursorrules: Redacta reglas de Cursor (.cursorrules) con pautas estructuradas, vista previa en vivo y exportación en Markdown.
  • Generador de CLAUDE.md: Generador estructurado de archivos CLAUDE.md para Claude Code con comandos, convenciones y exportación.
  • Generador de .windsurfrules: Redacta reglas de Windsurf (.windsurfrules) con pautas estructuradas, vista previa en vivo y exportación en Markdown.

Legal

Opcional