Referencia de comandos de la CLI de Mintlify

Para instalar la CLI, consulta Instalar la CLI.

Estos flags están disponibles en todos los comandos.

Inicia una previsualización local de tu documentación.

mint dev [flags]

Instala el servidor MCP Index alojado de Mintlify en tus agentes de codificación. El servidor proporciona una herramienta context para investigar bibliotecas, frameworks, SDK, API y herramientas CLI.

El servidor MCP Index es independiente del servidor MCP de Mintlify Docs, que busca en tu sitio de documentación.

mint index [options]

El comando también está disponible como mintlify index.

Ejecuta mint index sin opciones de cliente para detectar los clientes instalados y abrir un selector interactivo. Los clientes detectados aparecen seleccionados de forma predeterminada. Selecciona los clientes que quieres configurar y confirma el aviso.

Pasa una o más opciones de cliente para configurar clientes específicos sin abrir el selector:

mint index --claude --cursor

Usa --yes para configurar todos los clientes detectados sin avisos. Si no se detecta ningún cliente, pasa una opción explícita como --claude o --cursor.

Usa --project con opciones de cliente para escribir la configuración del proyecto en el directorio actual:

mint index --project --cursor --vscode

El comando añade el servidor mintlify-index a cada cliente seleccionado y lo apunta a https://index.mintlify.com/mcp. De forma predeterminada, actualiza la configuración global. Con --project, usa la configuración del proyecto cuando el cliente la admite.

El comando también añade una regla de uso para cada cliente seleccionado excepto Zed. La regla indica al cliente que use la herramienta context del MCP Index para investigar documentación, incluyendo sintaxis, configuración, migraciones y configuración inicial. Indica al cliente que prefiera la herramienta a la búsqueda web porque los datos de entrenamiento pueden estar desactualizados. La regla excluye conceptos generales de programación y la depuración de lógica de negocio.

Windsurf solo tiene configuración MCP global. Con --project, el comando sigue escribiendo la entrada MCP en la configuración global de Windsurf y escribe la regla de uso en el proyecto actual.

Si vuelves a ejecutar el comando, actualiza la entrada mintlify-index existente y su regla generada. Conserva el resto de la configuración. Si una configuración JSON o JSONC existente no es válida, el comando muestra un error sin modificar ese archivo.

Los clientes compatibles y sus archivos de configuración estándar incluyen:

Crea una nueva cuenta de Mintlify desde la terminal.

mint signup [flags]

Ejecuta el comando sin flags para introducir tus datos de forma interactiva. La CLI te pedirá cualquier valor que no pases como flag.

Después de enviar tus datos, Mintlify envía un enlace de verificación a tu correo electrónico. El comando espera hasta que haces clic en el enlace, luego crea tu cuenta, inicia sesión y almacena tus credenciales. Cuando termina, abre el panel de control para conectar tu repositorio y empezar a construir.

# Registro interactivo
mint signup

# Registro con todos los datos proporcionados
mint signup \
  --firstName Jane \
  --lastName Doe \
  --company Acme \
  --email [email protected]

Autenticarse con tu cuenta de Mintlify.

mint login

Abre una ventana del navegador para completar la autenticación. Si el navegador no se abre, la CLI muestra una URL para abrir manualmente y un campo para pegar el código de autorización. Las credenciales se guardan en ~/.config/mintlify/config.json.

Si tienes más de un despliegue, la CLI te solicita que selecciones uno predeterminado después de iniciar sesión. Puedes cambiar el proyecto predeterminado más tarde con mint config set subdomain <subdomain>.

Eliminar las credenciales almacenadas.

mint logout

Muestra los detalles de tu sesión actual, incluyendo la versión de la CLI, el correo electrónico de la cuenta, la organización y el subdominio configurado.

mint status

Añade un dominio personalizado a tu implementación desde la terminal. Requiere autenticación con mint login.

mint add-domain <domain> [--basePath <path>]

El comando usa el subdominio configurado con mint config. Si no hay ninguno configurado, usa el primer subdominio de tu cuenta.

Una vez registrado el dominio, la CLI espera hasta 10 segundos a que se generen los registros DNS y luego imprime los registros TXT y CNAME que debes añadir en tu proveedor de dominio:

TXT _acme-challenge → <value>
TXT _cf-custom-hostname → <value>
CNAME @ → cname.mintlify.builders

Añade primero los registros TXT y, una vez validados, añade el CNAME. Consulta Dominio personalizado para ver las instrucciones completas de configuración de DNS, los requisitos para dominios apex y los detalles del aprovisionamiento de TLS.

Si el comando falla con Domain is already in use by another deployment in your organization o Domain is already claimed by another organization, el dominio está vinculado a otra implementación de Mintlify. Consulta Al añadir un dominio aparece el error “Domain is already claimed by another organization” para liberarlo y volver a añadirlo.

Cuando pasas --basePath, la CLI guarda el base path después de registrar el dominio. El nuevo path se aplica en tu próximo despliegue, y tu sitio sigue sirviéndose desde el path actual hasta entonces. El CNAME envía todo el tráfico del dominio a Mintlify, así que solo añádelo si el dominio no aloja nada más. En caso contrario, mantén tu DNS actual y configura un reverse proxy a Mintlify para el base path. Consulta Hospedar la documentación en un subpath para ver guías por proveedor.

Ejemplos

Añade un dominio personalizado en la raíz:

mint add-domain docs.example.com

Añade un dominio personalizado y sirve tu documentación en /docs:

mint add-domain example.com --basePath /docs

Crea, lista y elimina automatizaciones desde la terminal. Requiere autenticación con mint login.

mint automations <subcommand> [flags]

Todos los subcomandos aceptan estos flags compartidos:

Cuando se establece --format json, los errores se imprimen en stderr como Error: <message> y el comando sale con un estado distinto de cero, para que puedas canalizar la salida exitosa a otras herramientas.

Crea una nueva automatización. Puedes pasar la definición de la automatización en línea con flags, o apuntar a un archivo JSON o YAML con --file.

mint automations create [flags]

Proporciona exactamente un trigger: pasa --cron para una automatización programada o uno o más flags --push-repo para una automatización activada por push.

# Automatización de traducciones programada
mint automations create \
  --name "Translate content" \
  --type translations \
  --cron "0 6 * * *"

# Automatización activada por push con contexto adicional
mint automations create \
  --name "Sync API reference" \
  --type source-code-agent \
  --push-repo my-org/api \
  --context-repo my-org/shared-types \
  --automerge

# Crear desde un archivo
mint automations create --file automation.yaml

Un archivo de automatización usa la misma forma que los flags en línea. El campo on contiene el trigger:

name: Translate content
type: translations
on:
  cron: "0 6 * * *"
prompt: Prefer formal tone in French translations.
automerge: false
context:
  - repo: my-org/shared-content

Lista las automatizaciones del despliegue actual.

mint automations list [flags]

La salida en formato tabla por defecto muestra el ID, nombre, tipo, trigger y estado de cada automatización. Usa --format json para obtener los objetos completos de la automatización.

Elimina una automatización por ID. Usa mint automations list para obtener el ID.

mint automations delete <id> [flags]

Consulta las analíticas de la documentación desde la terminal. Requiere autenticación con mint login.

mint analytics <subcommand> [flags]

Todos los subcomandos aceptan estos flags compartidos:

Muestra los KPIs principales para un rango de fechas: vistas, visitantes, búsquedas, feedback y uso del asistente. El tráfico humano y el de agentes se reportan por separado.

mint analytics stats [flags]

Muestra las consultas de búsqueda con el número de resultados, la tasa de clics, la página más clicada y la fecha de la última búsqueda.

mint analytics search [flags]

Muestra el feedback enviado por los usuarios. Por defecto, devuelve entradas individuales de feedback. Pasa --type page para ver el feedback agregado por ruta de página, o --type code para incluir solo el feedback sobre fragmentos de código.

mint analytics feedback [flags]

Consulta las analíticas de las conversaciones del asistente.

Lista las conversaciones recientes del asistente con marca de tiempo, primera consulta del usuario y categoría.

mint analytics conversation list [flags]

Consulta el hilo completo de mensajes de una sola conversación.

mint analytics conversation view <id> [flags]

Lista los clústeres de conversaciones agrupadas por tema, con el número de conversaciones y la fecha de la pregunta más reciente para cada clúster.

mint analytics conversation buckets list [flags]

Lista los hilos individuales de un bucket de conversaciones.

mint analytics conversation buckets view <id> [flags]

# KPIs de los últimos 30 días
mint analytics stats --from 2026-07-25 --to 2026-08-24

# Principales consultas de búsqueda en un gráfico de barras
mint analytics search --format graph

# Feedback a nivel de página agregado en JSON para canalizar a otras herramientas
mint analytics feedback --type page --format json

# Consulta un único hilo de conversación
mint analytics conversation view conv_123

Gestiona valores predeterminados persistentes para los comandos de la CLI. La configuración se guarda en ~/.config/mintlify/config.json.

mint config <subcommand> <key> [value]

Verifica enlaces rotos internos en tu documentación.

mint broken-links [flags]

El comando excluye los archivos que coinciden con los patrones de .mintignore. Los enlaces que apuntan a archivos ignorados se reportan como rotos.

Usa --files para limitar la verificación a páginas específicas. Es útil para validar una sola página que acabas de editar o para acotar las verificaciones a un directorio en CI. Cuando se combina --files con --check-external, solo se comprueban las URLs externas de las páginas seleccionadas.

# Verificar una página específica
mint broken-links --files introduction.mdx

# Verificar páginas que coincidan con un glob
mint broken-links --files "guides/**/*.mdx"

# Pasar varias rutas
mint broken-links --files introduction.mdx --files "guides/**/*.mdx"

Verifica problemas de accesibilidad en tu documentación.

mint a11y [flags]

Verifica las relaciones de contraste de color y la falta de texto alternativo en imágenes y videos.

Valida la compilación de tu documentación en modo estricto. Finaliza con error si hay advertencias o errores. Incluye validación automática de las especificaciones OpenAPI referenciadas en tu docs.json.

mint validate [flags]

Genera pruebas a partir de los ejemplos de código de tu documentación. Requiere autenticación con mint login.

mint test

mint test analiza tu contenido en busca de bloques de código, genera pruebas unitarias para validarlos y ejecuta las pruebas con un agente de codificación local.

• Autentícate con mint login.

• Instala el SDK del agente de codificación que quieras usar:

  # Claude (default)
  npm install @anthropic-ai/claude-agent-sdk @anthropic-ai/sdk @modelcontextprotocol/sdk
  
  # Codex
  npm install @openai/codex-sdk

Solo las páginas incluidas en la navegación de tu docs.json aparecen para su selección.

mint test guarda un informe de cada ejecución completada. Cuando existe un informe guardado, la siguiente ejecución interactiva comienza con opciones para esa ejecución:

• Update tests: vuelve a ejecutar las mismas páginas con el mismo agente y modelo.
• Review last test run: consulta los resultados guardados sin ejecutar nada.
• Start a brand new test: selecciona un agente y páginas desde cero.

El comando mint test escribe en dos ubicaciones de tu proyecto:

Agrega ambas rutas a tu .gitignore si no quieres confirmar los artefactos de prueba.

Cuando termina una ejecución, el comando imprime un resumen de resultados, por ejemplo mint test passed: 8 passed, 0 failed, 0 agent errors. El comando sale con el código 0 cuando todas las pruebas pasan y con 1 en caso contrario.

Exporta tu documentación como un archivo zip autónomo para visualización y distribución sin conexión.

mint export [flags]

Consulta Exportación offline para más detalles.

Ejecuta verificaciones de preparación para agentes en un sitio de documentación público. Requiere autenticación con mint login.

mint score [url] [flags]

El comando muestra una puntuación general de preparación y un desglose de verificaciones individuales con indicadores de aprobado/reprobado.

# Evaluar tu subdominio por defecto
mint score

# Evaluar un sitio específico
mint score docs.example.com

La puntuación evalúa las siguientes áreas:

Algunas verificaciones solo se ejecutan si una verificación de la que dependen pasa. Si una verificación falla, ninguna de las verificaciones que dependen de ella se ejecuta. Fallan automáticamente. Por ejemplo, llmsTxtValid solo pasa si llmsTxtExists pasa primero.

La puntuación general utiliza puntuación ponderada, por lo que las verificaciones de mayor impacto contribuyen más a su puntuación.

Formatea todos los archivos .mdx del directorio actual siguiendo el estilo canónico de Mintlify. El comando analiza cada archivo con el mismo analizador MDX que utiliza el editor web y luego lo reescribe in situ si la salida canónica difiere.

mint format

Ejecuta el comando desde la raíz de tu proyecto de documentación. Recorre cada subdirectorio, omitiendo las rutas que coincidan con .gitignore y cualquier regla de exclusión de Mintlify. Los archivos que ya coincidan con la salida canónica se dejan intactos.

Cuando termina, el comando muestra cuántos archivos MDX se reformatearon y cuántos no se pudieron analizar. Si algún archivo falla, el comando termina con el código 1 e imprime la ruta del archivo y el error, de modo que puedas ejecutarlo en CI para exigir un formato coherente. Consulta Instalar en CI para ver un pipeline de ejemplo.

Crea un nuevo proyecto de documentación eligiendo un tema o clonando una plantilla predefinida del repositorio mintlify/templates.

mint new [directory] [flags]

Actualiza la CLI a la última versión.

mint update

Muestra las versiones actuales de la CLI y del cliente.

mint version

Estos comandos están disponibles para ejecutar pero aún no son funcionales. Ejecutarlos registra tu interés a través de la telemetría de la CLI y ayuda a priorizar qué se lanza a continuación.

La CLI recopila telemetría de uso para ayudar a mejorar Mintlify. Los datos de telemetría incluyen el nombre del comando, la versión de la CLI, el sistema operativo y la arquitectura. Si has iniciado sesión, los eventos de telemetría también incluyen el correo electrónico de tu cuenta. El uso sin sesión iniciada permanece anónimo, y cerrar sesión elimina tu correo electrónico almacenado. Mintlify no recopila contenido del proyecto ni rutas de archivos.

Por defecto, la CLI recopila datos de telemetría. Puedes desactivarla en cualquier momento usando el flag --telemetry:

# Deshabilitar telemetría
mint --telemetry false

# Volver a habilitar telemetría
mint --telemetry true

También puedes deshabilitar la telemetría configurando una de estas variables de entorno:

Tu preferencia se guarda en ~/.config/mintlify/config.json y persiste entre sesiones de la CLI.