Saltar al contenido

Inicio rápido

Comprueba versión y ayuda antes de comprobar el cliente. doctor --output-json es un diagnóstico; revisa campos y código de salida.

ml-cli --version
ml-cli doctor --output-json
ml-cli status
ml-cli env list --page-no 1 --page-size 20
ml-cli cloudphone list --page-no 1 --page-size 20

Autenticación y puerto

Si hace falta iniciar sesión, proporciona API ID y API Key a login. La clave Bearer de Local API se envía aparte en las llamadas. Los valores son marcadores. Prioridad: --port → ML_PORT → IPC.

ml-cli login --api-id YOUR_API_ID --api-key YOUR_API_KEY
export ML_API_KEY="YOUR_LOCAL_API_KEY"
ml-cli --port 40000 env list
$env:ML_API_KEY = "YOUR_LOCAL_API_KEY"
ml-cli --port 40000 env list

JSON, salida y códigos

--json-data (alias --json) aporta el objeto base; los flags explícitos prevalecen. Los omitidos conservan el JSON. Los booleanos de aplicaciones requieren true o false explícitos; false se conserva. Consulta los campos obligatorios en la ayuda.

ml-cli --format table env list
ml-cli --fail-on-business-error cloudphone info --id "$PHONE_ID"
ml-cli --verbose env list
ml-cli --quiet env list
ml-cli env list | jq ".data.dataList"

JSON es el formato predeterminado. --format table muestra una vista resumida; usa JSON para datos completos y tuberías. --verbose escribe diagnóstico en stderr y oculta claves sensibles conocidas; --quiet suprime stdout exitoso. Son incompatibles.

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

Tiempos de espera y diagnóstico

El timeout predeterminado es 15 segundos; env core-download usa 1810. --timeout prevalece. Usa 30 segundos para abrir navegadores y 120 para abrir/encender teléfonos.

IPC usa /tmp/MoreLogin-cli en macOS/Linux y \\.\pipe\MoreLogin-cli en Windows. Ante connect EPERM 127.0.0.1:<port>, revisa permisos locales del agente y el estado antes de volver a iniciar. Un timeout deja el resultado incierto; consulta antes de repetir escrituras.