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

# Instalación de la CLI

> Instala la CLI para previsualizar y desarrollar tu documentación de forma local

<img className="block dark:hidden my-0 pointer-events-none" src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/installation/local-development-light.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=6525a601adf38652082acfa170797829" width="1184" height="320" data-path="images/installation/local-development-light.png" />

<img className="hidden dark:block my-0 pointer-events-none" src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/installation/local-development-dark.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=c3239d807129b6f835400e3d926d964c" width="1184" height="320" data-path="images/installation/local-development-dark.png" />

<div id="installing-the-cli">
  ## Instalación de la CLI
</div>

<Info>
  **Requisito previo**: Instala [Node.js](https://nodejs.org/en) antes de continuar.
</Info>

<Steps>
  <Step title="Instala la CLI.">
    Ejecuta el siguiente comando para instalar la [CLI](https://www.npmjs.com/package/mint):

    <CodeGroup>
      ```bash npm theme={null}
      npm i -g mint
      ```

      ```bash pnpm theme={null}
      pnpm add -g mint
      ```
    </CodeGroup>
  </Step>

  <Step title="Vista previa local.">
    Ve a tu directorio de documentación (donde se encuentra el archivo `docs.json`) y ejecuta el siguiente comando:

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

    La vista previa local de tu documentación estará disponible en `http://localhost:3000`.
  </Step>
</Steps>

Como alternativa, si no quieres instalar la CLI de forma global, puedes ejecutar un script único:

```bash theme={null}
npx mint dev
```

<div id="updates">
  ## Actualizaciones
</div>

Si la vista previa local no coincide con lo que ves en la versión de producción en la web, actualiza tu CLI local:

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

Si el comando `mint update` no está disponible en tu versión local, reinstala la CLI a la versión más reciente:

<CodeGroup>
  ```bash npm theme={null}
  npm i -g mint@latest
  ```

  ```bash pnpm theme={null}
  pnpm add -g mint@latest
  ```
</CodeGroup>

<div id="custom-ports">
  ## Puertos personalizados
</div>

De forma predeterminada, la CLI utiliza el puerto 3000. Puedes personalizar el puerto usando la opción `--port`. Para ejecutar la CLI en el puerto 3333, por ejemplo, usa este comando:

```bash theme={null}
mint dev --port 3333
```

Si intentas ejecutar en un puerto que ya está en uso, se usará el siguiente puerto disponible:

```mdx theme={null}
El puerto 3000 ya está en uso. Probando con el 3001.
```

<div id="previewing-as-a-specific-group">
  ## Vista previa como un grupo específico
</div>

Si usas Autenticación parcial para restringir el acceso a tu documentación, puedes obtener una vista previa como un grupo de autenticación específico usando la opción `--group [groupname]`.

Por ejemplo, si tienes un grupo llamado `admin`, puedes obtener una vista previa como miembro de ese grupo con el siguiente comando:

```bash theme={null}
mint dev --group admin
```

<div id="additional-commands">
  ## Comandos adicionales
</div>

Aunque `mint dev` es el comando más utilizado, hay otros comandos que puedes usar para administrar tu documentación.

<div id="finding-broken-links">
  ### Detección de enlaces rotos
</div>

La CLI puede ayudarte a validar los enlaces de referencia de tu documentación. Para identificar enlaces rotos, usa el siguiente comando:

```bash theme={null}
mint enlaces-rotos
```

<div id="checking-openapi-spec">
  ### Verificar la especificación de OpenAPI
</div>

Puedes usar la CLI para revisar tu archivo de OpenAPI en busca de errores con el siguiente comando:

```bash theme={null}
mint openapi-check <archivoOpenapiOUrl>
```

Puedes proporcionar un nombre de archivo (por ejemplo, `./openapi.yaml`) o una URL (por ejemplo, `https://petstore3.swagger.io/api/v3/openapi.json`).

<div id="renaming-files">
  ### Cambiar el nombre de archivos
</div>

Puedes cambiar el nombre y actualizar todas las referencias a archivos con el siguiente comando:

```bash theme={null}
mint rename <nombreArchivoAnterior> <nombreArchivoNuevo>
```

<div id="migrating-mdx-endpoint-pages">
  ### Migrar páginas de endpoints en MDX
</div>

Puedes migrar páginas de endpoints en MDX a páginas autogeneradas a partir de tu especificación de OpenAPI con el siguiente comando:

```bash theme={null}
mint migrate-mdx
```

Este comando convierte páginas individuales de endpoints en MDX en páginas autogeneradas definidas en tu `docs.json`, mueve el contenido de MDX a la extensión `x-mint` en tu especificación de OpenAPI y actualiza tu navegación. Consulta [Migración desde MDX](/es/api-playground/migrating-from-mdx) para obtener información detallada.

<div id="formatting">
  ## Formateo
</div>

Al desarrollar localmente, recomendamos usar extensiones en tu IDE para reconocer y dar formato a archivos `MDX`.

Si usas Cursor, Windsurf o VS Code, recomendamos la [extensión MDX para VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) para el resaltado de sintaxis y [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) para el formateo de código.

Si usas JetBrains, recomendamos el [plugin MDX para IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) para el resaltado de sintaxis y configurar [Prettier](https://prettier.io/docs/webstorm) para el formateo de código.

<div id="troubleshooting">
  ## Solución de problemas
</div>

<AccordionGroup>
  <Accordion title="Error: Could not load the &#x22;sharp&#x22; module using the darwin-arm64 runtime">
    Esto puede deberse a una versión desactualizada de Node. Prueba lo siguiente:

    1. Desinstala la versión actualmente instalada de la CLI de mint: `npm uninstall -g mint`
    2. Actualiza a Node.js.
    3. Reinstala la CLI de mint: `npm install -g mint`
  </Accordion>

  <Accordion title="Problema: error desconocido">
    **Solución**: Ve al directorio raíz de tu usuario y elimina la carpeta `~/.mintlify`. Después, ejecuta `mint dev` de nuevo.
  </Accordion>

  <Accordion title="Error: permiso denegado">
    Esto se debe a no tener los permisos necesarios para instalar paquetes de Node de forma global.

    **Solución**: Intenta ejecutar `sudo npm i -g mint`. Se te pedirá tu contraseña, la misma que usas para desbloquear tu computadora.
  </Accordion>

  <Accordion title="La vista previa local no se ve igual que mi documentación en la web">
    Es probable que se deba a una versión desactualizada de la CLI.

    **Solución:** Ejecuta `mint update` para obtener los cambios más recientes.
  </Accordion>

  <Accordion title="mintlify vs. paquete mint">
    Si tienes algún problema con el paquete de la CLI, primero ejecuta `npm ls -g`. Este comando muestra qué paquetes están instalados globalmente en tu máquina.

    Si no usas npm o no lo ves en la lista con -g, prueba `which mint` para localizar la instalación.

    Si tienes un paquete llamado `mint` y otro llamado `mintlify` instalado, debes desinstalar `mintlify`.

    1. Desinstala el paquete antiguo:

    ```bash theme={null}
      npm uninstall -g mintlify
    ```

    2. Limpia la caché de npm:

    ```bash theme={null}
      npm cache clean --force
    ```

    3. Reinstala el paquete nuevo:

    ```bash theme={null}
    npm i -g mint
    ```
  </Accordion>
</AccordionGroup>