> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos

> Referencia completa de todos los comandos y flags de la CLI de Mintlify, incluyendo mint dev, mint build, mint validate, mint broken-links y más.

<div id="global-flags">
  ## Flags globales
</div>

Estos flags están disponibles en todos los comandos.

| Flag                | Descripción                                            |
| ------------------- | ------------------------------------------------------ |
| `--telemetry`, `-t` | Habilitar o deshabilitar la telemetría anónima de uso. |
| `--help`, `-h`      | Mostrar la ayuda del comando.                          |
| `--version`, `-v`   | Mostrar la versión de la CLI. Alias de `mint version`. |

<div id="mint-dev">
  ## `mint dev`
</div>

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

```bash theme={null}
mint dev [flags]
```

| Flag                | Descripción                                                                        |
| ------------------- | ---------------------------------------------------------------------------------- |
| `--port`            | Puerto para ejecutar la previsualización local. Por defecto `3000`.                |
| `--no-open`         | No abrir el navegador automáticamente.                                             |
| `--groups`          | Lista separada por comas de grupos de usuarios a simular para la previsualización. |
| `--disable-openapi` | Omitir el procesamiento de archivos OpenAPI para mejorar el rendimiento.           |
| `--local-schema`    | Permitir archivos OpenAPI alojados localmente servidos por HTTP.                   |

***

<div id="mint-login">
  ## `mint login`
</div>

Autenticarse con tu cuenta de Mintlify.

```bash theme={null}
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>`.

***

<div id="mint-logout">
  ## `mint logout`
</div>

Eliminar las credenciales almacenadas.

```bash theme={null}
mint logout
```

***

<div id="mint-status">
  ## `mint status`
</div>

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.

```bash theme={null}
mint status
```

***

<div id="mint-automations">
  ## `mint automations`
</div>

Crea, lista y elimina [automatizaciones](/es/automations) desde la terminal. Requiere autenticación con `mint login`.

```bash theme={null}
mint automations <subcommand> [flags]
```

<Note>
  `mint workflow` y `mint workflows` siguen funcionando como alias de `mint automations`, por lo que los scripts existentes seguirán ejecutándose. Los scripts nuevos deben usar `mint automations`.
</Note>

Todos los subcomandos aceptan estos flags compartidos:

| Flag          | Descripción                                                                                                                              |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `--subdomain` | Subdominio de la documentación. Por defecto usa el valor establecido con `mint config set subdomain`, o el primer proyecto de tu cuenta. |
| `--format`    | Formato de salida: `table` (por defecto, en formato legible) o `json` (sin procesar, legible por máquinas).                              |

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.

<div id="mint-automations-create">
  ### `mint automations create`
</div>

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`.

```bash theme={null}
mint automations create [flags]
```

| Flag             | Descripción                                                                                                                                                                                                                                                                  |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--name`         | Nombre de la automatización. Obligatorio salvo que se proporcione `--file`.                                                                                                                                                                                                  |
| `--prompt`       | Instrucciones que se añaden al prompt base de la automatización en cada ejecución.                                                                                                                                                                                           |
| `--type`         | Tipo de automatización. Uno de `changelog`, `source-code-agent`, `translations`, `writing-style`, `typo-check`, `broken-link-detection`, `seo-metadata-audit`, `assistant-docs-updates` o `contextual-feedback-docs-updates`. Omítelo para una automatización personalizada. |
| `--cron`         | Expresión cron para un trigger programado. Mutuamente excluyente con `--push-repo`.                                                                                                                                                                                          |
| `--push-repo`    | Repositorio (`owner/repo`) para un trigger de push. Repetible para escuchar varios repositorios. Mutuamente excluyente con `--cron`.                                                                                                                                         |
| `--context-repo` | Repositorio de contexto adicional (`owner/repo`) que el agente lee cuando se ejecuta la automatización. Repetible, hasta 10 en total.                                                                                                                                        |
| `--automerge`    | Fusiona automáticamente las pull requests abiertas por esta automatización. Consulta [Configurar automerge](/es/guides/configure-automerge) para los requisitos de configuración.                                                                                            |
| `--file`         | Ruta a un archivo JSON o YAML con el cuerpo completo de la automatización. Anula los flags en línea.                                                                                                                                                                         |

Se requiere 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.

<div id="examples">
  #### Ejemplos
</div>

```bash theme={null}
# 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:

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

<div id="mint-automations-list">
  ### `mint automations list`
</div>

Lista las automatizaciones del despliegue actual.

```bash theme={null}
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.

<div id="mint-automations-delete">
  ### `mint automations delete`
</div>

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

```bash theme={null}
mint automations delete <id> [flags]
```

| Argumento | Descripción                                               |
| --------- | --------------------------------------------------------- |
| `id`      | ID del esquema de la automatización que se va a eliminar. |

***

<div id="mint-config">
  ## `mint config`
</div>

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

```bash theme={null}
mint config <subcommand> <key> [value]
```

| Subcomando          | Descripción                           |
| ------------------- | ------------------------------------- |
| `set <key> <value>` | Establecer un valor de configuración. |
| `get <key>`         | Mostrar un valor de configuración.    |
| `clear <key>`       | Eliminar un valor de configuración.   |

<div id="configuration-keys">
  ### Claves de configuración
</div>

| Clave       | Descripción                                    | Usado por          |
| ----------- | ---------------------------------------------- | ------------------ |
| `subdomain` | Subdominio predeterminado de la documentación. | `mint automations` |

***

<div id="mint-broken-links">
  ## `mint broken-links`
</div>

Verifica enlaces rotos internos en tu documentación.

```bash theme={null}
mint broken-links [flags]
```

El comando excluye los archivos que coinciden con los patrones de [.mintignore](/es/organize/mintignore). Los enlaces que apuntan a archivos ignorados se reportan como rotos.

| Flag                | Descripción                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------ |
| `--check-anchors`   | También validar enlaces de ancla (por ejemplo, `/page#section`) contra los slugs de encabezados. |
| `--check-external`  | También verificar URLs externas en busca de enlaces rotos.                                       |
| `--check-redirects` | También verificar que los destinos de redirección en `docs.json` se resuelvan a rutas válidas.   |
| `--check-snippets`  | También verificar enlaces dentro de componentes `<Snippet>`.                                     |

***

<div id="mint-a11y">
  ## `mint a11y`
</div>

Verifica problemas de accesibilidad en tu documentación.

```bash theme={null}
mint a11y [flags]
```

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

| Flag              | Descripción                                              |
| ----------------- | -------------------------------------------------------- |
| `--skip-contrast` | Omitir las verificaciones de contraste de color.         |
| `--skip-alt-text` | Omitir las verificaciones de texto alternativo faltante. |

***

<div id="mint-validate">
  ## `mint validate`
</div>

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`.

```bash theme={null}
mint validate [flags]
```

| Flag                | Descripción                                                                                                        |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `--groups`          | Lista separada por comas de grupos de usuarios a simular para la validación.                                       |
| `--disable-openapi` | Omitir el procesamiento y validación de archivos OpenAPI.                                                          |
| `--local-schema`    | Permitir la validación de archivos OpenAPI alojados localmente servidos por HTTP. Solo admite HTTPS en producción. |

<Note>
  El comando independiente `mint openapi-check` está obsoleto. Usa `mint validate` en su lugar.
</Note>

***

<div id="mint-export">
  ## `mint export`
</div>

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

```bash theme={null}
mint export [flags]
```

| Flag                | Descripción                                                                       |
| ------------------- | --------------------------------------------------------------------------------- |
| `--output`          | Nombre del archivo de salida. Por defecto `export.zip`.                           |
| `--groups`          | Lista separada por comas de grupos de usuarios para incluir páginas restringidas. |
| `--disable-openapi` | Omitir el procesamiento de OpenAPI.                                               |

Consulta [Exportación offline](/es/deploy/export) para más detalles.

***

<div id="mint-score">
  ## `mint score`
</div>

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

```bash theme={null}
mint score [url] [flags]
```

| Argumento | Descripción                                                                                                                                                                                           |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`     | Opcional. URL del sitio de documentación que se va a comprobar. Si se omite, el comando evalúa tu subdominio configurado (de `mint config` o el subdominio asociado a tu cuenta con sesión iniciada). |

| Flag       | Descripción                                                                                        |
| ---------- | -------------------------------------------------------------------------------------------------- |
| `--format` | Formato de salida: `table` (predeterminado, con colores), `plain` (TSV para redirección) o `json`. |

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

<div id="examples">
  ### Ejemplos
</div>

```bash theme={null}
# Evaluar tu subdominio por defecto
mint score

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

<div id="checks">
  ### Verificaciones
</div>

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

| Verificación                  | Qué comprueba                                                                                                                                                                                      |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `llmsTxtExists`               | Los agentes pueden acceder a un archivo [llms.txt](/es/ai/llmstxt) en la raíz del sitio.                                                                                                           |
| `llmsTxtValid`                | El archivo `llms.txt` sigue el formato esperado con encabezados, resumen en bloque de cita y enlaces Markdown.                                                                                     |
| `llmsTxtSize`                 | El archivo `llms.txt` está dentro del umbral de tamaño para que los agentes puedan consumirlo sin truncamiento.                                                                                    |
| `llmsTxtLinksResolve`         | Los enlaces dentro de `llms.txt` apuntan a páginas activas.                                                                                                                                        |
| `llmsTxtLinksMarkdown`        | Los enlaces dentro de `llms.txt` usan sintaxis Markdown.                                                                                                                                           |
| `llmsTxtDirective`            | El archivo `llms.txt` contiene directivas de uso.                                                                                                                                                  |
| `llmsTxtFullExists`           | Un archivo [llms-full.txt](/es/ai/llmstxt/#llms-full-txt) está disponible para agentes que necesitan el contenido completo. Se ejecuta independientemente de `llmsTxtExists`.                      |
| `llmsTxtFullSize`             | El archivo `llms-full.txt` tiene un tamaño razonable para que los agentes lo procesen.                                                                                                             |
| `llmsTxtFullValid`            | El archivo `llms-full.txt` contiene contenido válido con encabezados.                                                                                                                              |
| `llmsTxtFullLinksResolve`     | Los enlaces dentro de `llms-full.txt` apuntan a páginas activas.                                                                                                                                   |
| `skillMd`                     | Los agentes pueden acceder a un archivo [skill.md](https://www.mintlify.com/docs/ai/skillmd) para el uso de herramientas por agentes.                                                              |
| `contentNegotiationMarkdown`  | El sitio devuelve Markdown cuando los agentes lo solicitan mediante negociación de contenido.                                                                                                      |
| `contentNegotiationPlaintext` | El sitio devuelve texto plano cuando los agentes lo solicitan mediante negociación de contenido.                                                                                                   |
| `mcpServerDiscoverable`       | Los agentes pueden descubrir un [servidor MCP](/es/ai/model-context-protocol) para agentes basados en herramientas.                                                                                |
| `mcpToolCount`                | El servidor MCP expone al menos una herramienta.                                                                                                                                                   |
| `openApiSpec`                 | Hay una especificación OpenAPI o Swagger disponible en una ruta estándar.                                                                                                                          |
| `robotsTxtAllowsAI`           | El archivo `robots.txt` no bloquea los rastreadores de IA.                                                                                                                                         |
| `sitemapExists`               | Hay un mapa del sitio disponible para el descubrimiento de páginas.                                                                                                                                |
| `structuredData`              | La página principal contiene datos estructurados [JSON-LD](https://json-ld.org/) (`<script type="application/ld+json">`). Informa el número de bloques JSON-LD y los tipos de esquema encontrados. |
| `responseLatency`             | El sitio responde en un tiempo aceptable para los agentes.                                                                                                                                         |

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.

***

<div id="mint-new">
  ## `mint new`
</div>

Crea un nuevo proyecto de documentación eligiendo un tema o clonando una plantilla predefinida del repositorio [mintlify/templates](https://github.com/mintlify/templates).

```bash theme={null}
mint new [directory] [flags]
```

| Flag         | Descripción                                                                                             |
| ------------ | ------------------------------------------------------------------------------------------------------- |
| `--name`     | Nombre del proyecto. La CLI lo solicita si no se proporciona en modo interactivo.                       |
| `--theme`    | [Tema](/es/customize/themes) del proyecto. La CLI lo solicita si no se proporciona en modo interactivo. |
| `--template` | Plantilla predefinida. La CLI la solicita si no se proporciona en modo interactivo.                     |
| `--force`    | Sobrescribir el directorio sin solicitar confirmación.                                                  |

***

<div id="mint-update">
  ## `mint update`
</div>

Actualiza la CLI a la última versión.

```bash theme={null}
mint update
```

***

<div id="mint-version">
  ## `mint version`
</div>

Muestra las versiones actuales de la CLI y del cliente.

```bash theme={null}
mint version
```

***

<div id="coming-soon">
  ## Próximamente
</div>

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.

| Comando       | Descripción                           |
| ------------- | ------------------------------------- |
| `mint ai`     | Herramientas de documentación con IA. |
| `mint test`   | Pruebas de documentación.             |
| `mint signup` | Registro de cuenta desde la CLI.      |
| `mint mcp`    | Servidor MCP para documentación.      |

***

<div id="telemetry">
  ## Telemetría
</div>

La CLI recopila telemetría anónima 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. Mintlify **no** recopila información de identificación personal, 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`:

```bash theme={null}
# 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:

| Variable                      | Valor | Descripción                                                                                           |
| ----------------------------- | ----- | ----------------------------------------------------------------------------------------------------- |
| `MINTLIFY_TELEMETRY_DISABLED` | `1`   | Deshabilitar la telemetría de la CLI de Mintlify.                                                     |
| `DO_NOT_TRACK`                | `1`   | Deshabilitar la telemetría usando el estándar [Console Do Not Track](https://consoledonottrack.com/). |

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