# Descripción de CLI

`ml-cli` administra MoreLogin mediante la API local del cliente. También ofrece instalación, inicio, diagnóstico, integración con agentes, actualizaciones y autocompletado.

Referencia verificada con el código **2.8.3**, commit master `efac10e`. El changelog marca 2.8.x como Unreleased; no garantiza su disponibilidad en descargas. Comprueba la versión instalada.

```bash
ml-cli --version
ml-cli --help
ml-cli self-update --dry-run
```

## Descarga e instalación

Descarga el binario oficial para tu sistema y arquitectura:

| Plataforma | Arquitectura | Descarga |
|  --- | --- | --- |
| Windows | x64 | [ml-cli.exe](https://cb-gateway.morelogin.com/app/ver/public/latest/redirect?identify=MoreLogin_AirDrop_window_x64_cli) |
| macOS | Intel x64 | [ml-cli](https://cb-gateway.morelogin.com/app/ver/public/latest/redirect?identify=MoreLogin_AirDrop_darwin_x64_cli) |
| macOS | Apple Silicon arm64 | [ml-cli](https://cb-gateway.morelogin.com/app/ver/public/latest/redirect?identify=MoreLogin_AirDrop_darwin_arm64_cli) |
| Linux | x64 | [ml-cli](https://cb-gateway.morelogin.com/app/ver/public/latest/redirect?identify=MoreLogin_AirDrop_linux_x64_cli) |


En macOS/Linux, da permiso de ejecución y añade el binario al PATH. En Windows, añade la carpeta de `ml-cli.exe` al PATH del usuario y reabre la terminal. La [instalación del cliente](/es/cli/client) es independiente.

```bash
chmod +x ./ml-cli
sudo mv ./ml-cli /usr/local/bin/ml-cli
ml-cli --version
```

```powershell
$cliDir = Join-Path $env:LOCALAPPDATA "MoreLogin\bin"
New-Item -ItemType Directory -Force -Path $cliDir
Copy-Item .\ml-cli.exe (Join-Path $cliDir "ml-cli.exe")
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$cliDir", "User")
```

Los comandos Local API requieren un cliente abierto y con sesión iniciada. El puerto usa `--port`, luego `ML_PORT`, o descubrimiento automático. Si hay clave de seguridad, usa `--api-key` o `ML_API_KEY`; no publiques la clave.

## Funciones y guías

Grupos: `env`, `cloud-browser`, `cloudphone` (incluye aplicaciones del equipo), `group`, `tag`, `proxy`, `schedule` y `cloud-storage`. Consulta [Inicio rápido](/es/cli/quick-start), [Flujos](/es/cli/workflows), [Comandos](/es/cli/commands), [Agentes](/es/cli/agent) y [Cliente](/es/cli/client).

## Códigos de salida

- `0`: finalización normal. Sin comprobación estricta, HTTP 2xx puede contener un fallo de negocio.
- `1`: `code` de negocio no cero con `--fail-on-business-error`, u operación no compatible, como `env arrange` en Linux.
- `2`: argumentos o JSON inválidos, validación local, fallos de puerto/conexión, HTTP no 2xx o salida. Los fallos de detección o integridad estricta del cliente también usan `2`; revisa el estado.