Skip to content

Command Reference

This page contains all 129 help pages captured from CLI 2.8.3 (efac10e). Terminal help, command names, flags, enum values and examples are preserved verbatim in every language. Prose guides are translated.

See Quick Start, Resource Workflows, Client Setup and Agent Usage for complete workflows and outcome interpretation.

ml-cli --help

MoreLogin CLI - Lightweight Local API command-line tool

Usage: ml-cli [OPTIONS] <COMMAND>

Commands:
  agent-bootstrap  Print a compact JSON startup summary with diagnostics and guide pointers
  agent-guide      Print the AI-agent usage guide for MoreLogin CLI
  doctor           Diagnose MoreLogin Desktop local API connectivity
  install-prompt   Print the copy-to-agent setup prompt
  agent-package    Print the machine-readable AI agent package
  agent-list       List supported AI agent configuration targets
  agent-init       Generate or write persistent MoreLogin routing rules for an AI agent
  status           Check MoreLogin service status
  client           Inspect or install MoreLogin Client
  login            Authenticate with API credentials
  env              Browser environment management
  cloud-browser    Cloud browser management
  cloudphone       Cloud phone management
  group            Group management
  tag              Tag management
  proxy            Proxy management
  schedule         Cloud Phone Schedules management
  cloud-storage    Cloud storage file and label management
  self-update      Update ml-cli to the latest version
  completions      Generate shell completion scripts
  help             Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help
  -V, --version                 Print version

ml-cli agent-bootstrap

Print a compact JSON startup summary with diagnostics and guide pointers

Usage: ml-cli agent-bootstrap [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli agent-guide

Print the AI-agent usage guide for MoreLogin CLI

Usage: ml-cli agent-guide [OPTIONS]

Options:
      --output-json             Print as a JSON string instead of Markdown
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli doctor

Diagnose MoreLogin Desktop local API connectivity

Usage: ml-cli doctor [OPTIONS]

Options:
      --output-json             Print machine-readable JSON
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli install-prompt

Print the copy-to-agent setup prompt

Usage: ml-cli install-prompt [OPTIONS]

Options:
      --output-json             Print as a JSON string instead of plain text
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli agent-package

Print the machine-readable AI agent package

Usage: ml-cli agent-package [OPTIONS]

Options:
      --output-json             Print as a JSON string instead of Markdown
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli agent-list

List supported AI agent configuration targets

Usage: ml-cli agent-list [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli agent-init

Generate or write persistent MoreLogin routing rules for an AI agent

Usage: ml-cli agent-init [OPTIONS] --agent <AGENT>

Options:
      --agent <AGENT>           Target AI agent [possible values: codex, claude-code, cursor, gemini, qwen-code, opencode, openclaw, trae, hermes, qclaw, easyclaw, workbuddy]
      --scope <SCOPE>           Write user-level or project-level rules [default: user] [possible values: user, project]
      --write                   Write the rules file. Without this flag, the command only prints a dry-run JSON report
      --print                   Print only the rules block content
      --dry-run                 Explicit dry-run flag for readability. Dry-run is the default unless --write is passed
      --uninstall               Remove the MoreLogin rules block from the agent's rules file
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli status

Check MoreLogin service status

Usage: ml-cli status [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli client

Inspect or install MoreLogin Client

Usage: ml-cli client [OPTIONS] <COMMAND>

Commands:
  status   Check whether MoreLogin Client is installed on this machine
  install  Prepare the latest official MoreLogin Client installer
  open     Open an installed MoreLogin Client unless it is already running
  help     Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli client status

Check whether MoreLogin Client is installed on this machine

Usage: ml-cli client status [OPTIONS]

Options:
      --output-json             Print one machine-readable JSON object
      --require-integrity       Exit with code 2 when an installed Client fails or cannot complete integrity checks
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli client install

Prepare the latest official MoreLogin Client installer

Usage: ml-cli client install [OPTIONS]

Options:
      --interactive             Ask the operating system to open the prepared installer after platform checks
      --output-json             Print one machine-readable JSON object
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli client open

Open an installed MoreLogin Client unless it is already running

Usage: ml-cli client open [OPTIONS]

Options:
      --output-json             Print one machine-readable JSON object
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli login

Authenticate with API credentials

Usage: ml-cli login [OPTIONS]

Options:
      --api-id <API_ID>         API ID
      --api-key <API_KEY>       API Key
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env

Browser environment management

Usage: ml-cli env [OPTIONS] <COMMAND>

Commands:
  start                   Start browser environment (by ID, EnvID, or SN)
  close                   Close browser environment
  status                  Get status of browser environment
  close-all               Close all active environments
  clear-cache             Clear local environment cache
  screens                 Get all screen info
  arrange                 Arrange active windows
  processes               Get process IDs for all active environments
  debug-info              Get all debug info
  list                    Get a list of browser profiles
  find                    Find browser profiles by name and print matched candidates
  open                    Find and start exactly one browser profile by name
  create-quick            Quick create browser profile
  create-advanced         Advanced create browser profile (JSON body only)
  update                  Modify browser profile (JSON body only)
  delete                  Delete browser profile
  info                    Get browser profile details
  core-download           Download one or more browser cores
  ua-versions             Get browser core versions
  ua-get                  Get browser UA
  resolution-list         Get available resolutions
  platform-list           Get available platforms
  lock-query              Get browser lock status
  timezone-language-list  Get timezone and language list
  clear-cloud-cache       Clear cloud cache
  fingerprint-refresh     Refresh Fingerprint
  set-group               Batch set group
  set-proxy               Batch set proxy
  set-remark              Batch set remark
  mobile-devices          Mobile device models
  help                    Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env start

Start browser environment (by ID, EnvID, or SN)

Usage: ml-cli env start [OPTIONS]

Options:
      --id <ID>                    Profile ID (maps to id)
      --env-id <ENV_ID>            Environment ID (maps to envId)
      --unique-id <UNIQUE_ID>      Serial Number (maps to sn / uniqueId)
      --args <ARGS>                Extra args for starting
      --encrypt-key <ENCRYPT_KEY>  Encryption key for end-to-end encrypted environments
      --is-headless <true|false>   Start in headless mode [possible values: true, false]
      --cdp-evasion <true|false>   Enable CDP fingerprint evasion [possible values: true, false]
      --port <PORT>                httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>      Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error     Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>            Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                    Print diagnostic request details to stderr
      --quiet                      Suppress successful stdout output
  -h, --help                       Print help

ml-cli env close

Close browser environment

Usage: ml-cli env close [OPTIONS]

Options:
      --id <ID>
      --env-id <ENV_ID>
      --unique-id <UNIQUE_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env status

Get status of browser environment

Usage: ml-cli env status [OPTIONS]

Options:
      --id <ID>
      --env-id <ENV_ID>
      --unique-id <UNIQUE_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env close-all

Close all active environments

Usage: ml-cli env close-all [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env clear-cache

Clear local environment cache

Usage: ml-cli env clear-cache [OPTIONS]

Options:
      --id <ID>

      --env-id <ENV_ID>

      --unique-id <UNIQUE_ID>

      --remove-env-data <REMOVE_ENV_DATA>
          Hard delete environment data as well [possible values: true, false]
      --local-storage <LOCAL_STORAGE>
          Clear localStorage [possible values: true, false]
      --indexed-db <INDEXED_DB>
          Clear indexedDB [possible values: true, false]
      --cookie <COOKIE>
          Clear cookie [possible values: true, false]
      --extension <EXTENSION>
          Clear extension [possible values: true, false]
      --extension-file <EXTENSION_FILE>
          Clear extension files [possible values: true, false]
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli env screens

Get all screen info

Usage: ml-cli env screens [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env arrange

Arrange active windows

Usage: ml-cli env arrange [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env processes

Get process IDs for all active environments

Usage: ml-cli env processes [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env debug-info

Get all debug info

Usage: ml-cli env debug-info [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env list

Get a list of browser profiles

Usage: ml-cli env list [OPTIONS]

Options:
      --env-name <ENV_NAME>
      --group-id <GROUP_ID>
      --env-id <ENV_ID>
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env find

Find browser profiles by name and print matched candidates

Usage: ml-cli env find [OPTIONS]

Options:
      --name <NAME>             Profile name or name fragment to search
      --keyword <KEYWORD>       Keyword to search by profile name, group name, tag name, or remark
      --exact                   Require exact case-insensitive name match
      --page-no <PAGE_NO>       Page number to query before local matching
      --page-size <PAGE_SIZE>   Page size to query before local matching
      --limit <LIMIT>           Maximum matched candidates to print
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env open

Find and start exactly one browser profile by name

Usage: ml-cli env open [OPTIONS]

Options:
      --name <NAME>                Profile name or name fragment to search
      --keyword <KEYWORD>          Keyword to search by profile name, group name, tag name, or remark
      --exact                      Require exact case-insensitive name match
      --page-no <PAGE_NO>          Page number to query before local matching
      --page-size <PAGE_SIZE>      Page size to query before local matching
      --encrypt-key <ENCRYPT_KEY>  Encryption key for end-to-end encrypted environments
      --is-headless <true|false>   Start in headless mode [possible values: true, false]
      --cdp-evasion <true|false>   Enable CDP fingerprint evasion [possible values: true, false]
      --port <PORT>                httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>      Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error     Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>            Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                    Print diagnostic request details to stderr
      --quiet                      Suppress successful stdout output
  -h, --help                       Print help

ml-cli env create-quick

Quick create browser profile

Usage: ml-cli env create-quick [OPTIONS]

Options:
      --browser-type-id <BROWSER_TYPE_ID>
          Browser type. 1=Chrome, 2=Firefox
      --operator-system-id <OPERATOR_SYSTEM_ID>
          Operating system type. 1=Windows, 2=macOS, 3=Android, 4=iOS
      --quantity <QUANTITY>
          Number of environments to create. Range: 1-50
      --group-id <GROUP_ID>
          Environment group ID
      --proxy-id <PROXY_ID>
          Existing proxy ID to bind
      --proxy-ip <PROXY_IP>
          Proxy IP (required for most providers when not binding by proxyId)
      --proxy-port <PROXY_PORT>
          Proxy port (1-65535)
      --proxy-type <PROXY_TYPE>
          Proxy type. 0=http, 1=https
      --proxy-provider <PROXY_PROVIDER>
          Proxy provider. 0=http, 1=https, 2=socks5, 3=ssh, 4=Oxylabs, 5=Proxys.io, 7=Luminati, 8=Lumauto, 9=Oxylabsauto, 10=Trojan, 11=Shadowsocks, 13=ABCPROXY, 14=LunaProxy, 15=IPHTML, 16=PiaProxy, 17=922S5, 18=360Proxy
      --proxy-name <PROXY_NAME>
          Proxy display name
      --username <USERNAME>
          Proxy auth username
      --password <PASSWORD>
          Proxy auth password
      --refresh-url <REFRESH_URL>
          Dynamic proxy refresh URL
      --country <COUNTRY>
          Country / region code
      --state <STATE>
          State / province
      --city <CITY>
          City
      --encryption-type <ENCRYPTION_TYPE>
          Encryption type for Shadowsocks provider. 1=aes-128-gcm, 2=aes-192-gcm, 3=aes-256-gcm, 4=aes-128-cfb, 5=aes-192-cfb, 6=aes-256-cfb, 7=aes-128-ctr, 8=aes-192-ctr, 9=aes-256-ctr, 10=rc4-md5, 11=chacha20-ietf, 12=xchacha20, 13=chacha20-ietf-poly1305, 14=xchacha20-ietf-poly1305
      --ip-monitor <true|false>
          Enable IP change monitoring: true=on, false=off [possible values: true, false]
      --ip-change-action <IP_CHANGE_ACTION>
          IP change action. 0=block access, 1=warn
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli env create-advanced

Advanced create browser profile (JSON body only)

Usage: ml-cli env create-advanced [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

CLI behavior:
  - Only supports passing the request body via --json-data.
  - The CLI does not validate request fields for this endpoint.
  - Payload validation is handled by the API.

Example:
  ml-cli env create-advanced --json-data '{"browserTypeId":1,"operatorSystemId":1,"envName":"cli-adv-test"}'

ml-cli env update

Modify browser profile (JSON body only)

Usage: ml-cli env update [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

CLI behavior:
  - Only supports passing the request body via --json-data.
  - The CLI does not validate request fields for this endpoint.
  - Payload validation is handled by the API.

Example:
  ml-cli env update --json-data '{"envId":"1868548141708648448","envName":"cli-updated"}'

ml-cli env delete

Delete browser profile

Usage: ml-cli env delete [OPTIONS]

Options:
  -i, --env-ids <ENV_IDS>

      --remove-env-data <REMOVE_ENV_DATA>
          [possible values: true, false]
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli env info

Get browser profile details

Usage: ml-cli env info [OPTIONS]

Options:
      --env-id <ENV_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env core-download

Download one or more browser cores

Usage: ml-cli env core-download [OPTIONS]

Options:
      --core <BROWSER_TYPE:VERSION>  Browser core as <browser-type>:<version>; repeat for multiple cores
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

Each --core value uses <browser-type>:<version>, where 1=Chrome and 2=Firefox. Repeat --core to download 1-20 cores. The command may take about 30 minutes; its default timeout is 1810 seconds. An explicit global --timeout overrides that default.

Examples:
  ml-cli env core-download --core 1:124
  ml-cli --timeout 1810 env core-download --core 1:124 --core 2:146
  ml-cli env core-download --json-data '{"Cores":[{"BrowserType":1,"Version":"124"}]}'

ml-cli env ua-versions

Get browser core versions

Usage: ml-cli env ua-versions [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env ua-get

Get browser UA

Usage: ml-cli env ua-get [OPTIONS]

Options:
      --os <OS>                  Operating system type. 1=Windows, 2=macOS, 3=Android, 4=iOS
      --os-version <OS_VERSION>  OS version, for example: Windows 11, macOS 14
      --vendor <VENDOR>          Browser type. 1=Chrome, 2=Firefox
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli env resolution-list

Get available resolutions

Usage: ml-cli env resolution-list [OPTIONS]

Options:
      --os <OS>                 Operating system type. 1=Windows, 2=macOS, 3=Android, 4=iOS
      --ua <UA>                 User-Agent string used to filter matching resolutions
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env platform-list

Get available platforms

Usage: ml-cli env platform-list [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env lock-query

Get browser lock status

Usage: ml-cli env lock-query [OPTIONS]

Options:
      --env-id <ENV_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env timezone-language-list

Get timezone and language list

Usage: ml-cli env timezone-language-list [OPTIONS]

Options:
      --os <OS>                 Operating system type. 1=Windows, 2=macOS, 3=Android, 4=iOS
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env clear-cloud-cache

Clear cloud cache

Usage: ml-cli env clear-cloud-cache [OPTIONS]

Options:
      --cookie <COOKIE>         [possible values: true, false]
      --env-id <ENV_ID>
      --unique-id <UNIQUE_ID>
      --others <OTHERS>         [possible values: true, false]
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli env fingerprint-refresh

Refresh Fingerprint

Usage: ml-cli env fingerprint-refresh [OPTIONS]

Options:
      --env-id <ENV_ID>
          Environment ID
      --unique-id <UNIQUE_ID>
          Environment serial number
      --ua-version <UA_VERSION>
          Target browser UA version
      --browser-type-id <BROWSER_TYPE_ID>
          Browser type. 1=Chrome, 2=Firefox
      --operator-system-id <OPERATOR_SYSTEM_ID>
          Operating system type. 1=Windows, 2=macOS, 3=Android, 4=iOS
      --advanced-setting <ADVANCED_SETTING>
          Advanced fingerprint settings JSON object
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli env set-group

Batch set group

Usage: ml-cli env set-group [OPTIONS]

Options:
  -i, --env-ids <ENV_IDS>        Target environment IDs (maps to request envIds); choose this or --unique-ids
      --unique-ids <UNIQUE_IDS>  Target environment serial IDs (maps to request uniqueIds); choose this or --env-ids
      --group-name <GROUP_NAME>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

Target selection:
  - Pass either --env-ids or --unique-ids.
  - At least one of them is required.
  - They map to request fields envIds / uniqueIds.

Pass multiple targets by repeating the flag.

Examples:
  ml-cli env set-group --env-ids 1001 --env-ids 1002 --group-name cli-test-group
  ml-cli env set-group --unique-ids SN001 --unique-ids SN002 --group-name cli-test-group

ml-cli env set-proxy

Batch set proxy

Usage: ml-cli env set-proxy [OPTIONS]

Options:
      --env-ids <ENV_IDS>
          Target environment IDs (maps to request envIds); repeat --env-ids for multiple values
      --unique-ids <UNIQUE_IDS>
          Target environment serial IDs (maps to request uniqueIds); repeat --unique-ids for multiple values
      --proxy-id <PROXY_ID>
          Existing proxy ID to bind
      --proxy-ip <PROXY_IP>
          Proxy IP (required for most providers when not binding by proxyId)
      --proxy-port <PROXY_PORT>
          Proxy port (1-65535)
      --proxy-type <PROXY_TYPE>
          Proxy type. 0=http, 1=https
      --proxy-provider <PROXY_PROVIDER>
          Proxy provider. 0=http, 1=https, 2=socks5, 3=ssh, 4=Oxylabs, 5=Proxys.io, 7=Luminati, 8=Lumauto, 9=Oxylabsauto, 10=Trojan, 11=Shadowsocks, 13=ABCPROXY, 14=LunaProxy, 15=IPHTML, 16=PiaProxy, 17=922S5, 18=360Proxy
      --proxy-name <PROXY_NAME>
          Proxy display name
      --username <USERNAME>
          Proxy auth username
      --password <PASSWORD>
          Proxy auth password
      --refresh-url <REFRESH_URL>
          Dynamic proxy refresh URL
      --country <COUNTRY>
          Country / region code
      --state <STATE>
          State / province
      --city <CITY>
          City
      --encryption-type <ENCRYPTION_TYPE>
          Encryption type for Shadowsocks provider. 1=aes-128-gcm, 2=aes-192-gcm, 3=aes-256-gcm, 4=aes-128-cfb, 5=aes-192-cfb, 6=aes-256-cfb, 7=aes-128-ctr, 8=aes-192-ctr, 9=aes-256-ctr, 10=rc4-md5, 11=chacha20-ietf, 12=xchacha20, 13=chacha20-ietf-poly1305, 14=xchacha20-ietf-poly1305
      --ip-monitor <true|false>
          Enable IP change monitoring: true=on, false=off [possible values: true, false]
      --ip-change-action <IP_CHANGE_ACTION>
          IP change action. 0=block access, 1=warn
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

Request mapping:
  --env-ids -> envIds
  --unique-ids -> uniqueIds
  --proxy-* -> proxy.*

Pass multiple targets by repeating the flag.

Explicit CLI flags override matching keys inside --json-data.

Examples:
  ml-cli env set-proxy --env-ids 1001 --env-ids 1002 --proxy-ip 127.0.0.1 --proxy-port 8888 --proxy-type 0 --proxy-provider 0 --proxy-name local
  ml-cli env set-proxy --unique-ids SN001 --unique-ids SN002 --proxy-id 123
  ml-cli env set-proxy --env-ids 1001 --json-data '{"proxy":{"proxyProvider":"0"}}' --proxy-ip 127.0.0.1

ml-cli env set-remark

Batch set remark

Usage: ml-cli env set-remark [OPTIONS]

Options:
  -i, --env-ids <ENV_IDS>        Target environment IDs (maps to request envIds); choose this or --unique-ids
      --unique-ids <UNIQUE_IDS>  Target environment serial IDs (maps to request uniqueIds); choose this or --env-ids
      --env-remark <ENV_REMARK>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

Target selection:
  - Pass either --env-ids or --unique-ids.
  - At least one of them is required.
  - They map to request fields envIds / uniqueIds.

Pass multiple targets by repeating the flag.

Examples:
  ml-cli env set-remark --env-ids 1001 --env-remark cli-remark
  ml-cli env set-remark --unique-ids SN001 --env-remark cli-remark

ml-cli env mobile-devices

Mobile device models

Usage: ml-cli env mobile-devices [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-browser

Cloud browser management

Usage: ml-cli cloud-browser [OPTIONS] <COMMAND>

Commands:
  list     List cloud browser environments
  start    Start a cloud browser
  stop     Stop a cloud browser
  connect  Connect to a cloud browser desktop
  help     Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-browser list

List cloud browser environments

Usage: ml-cli cloud-browser list [OPTIONS]

Options:
      --env-id <ENV_ID>          Environment ID
      --env-name <ENV_NAME>      Environment name
      --group-id <GROUP_ID>      Group ID; use 0 for ungrouped environments
      --keyword <KEYWORD>        Filter by environment name, group name, tag name, or remark
      --page-no <PAGE_NO>        Page number (default: 1)
      --page-size <PAGE_SIZE>    Page size (default: 10; maximum: 100)
      --unique-ids <UNIQUE_IDS>  Environment serial IDs; repeat for multiple values
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli cloud-browser start

Start a cloud browser

Usage: ml-cli cloud-browser start [OPTIONS]

Options:
      --env-id <ENV_ID>         Environment ID
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-browser stop

Stop a cloud browser

Usage: ml-cli cloud-browser stop [OPTIONS]

Options:
      --env-id <ENV_ID>         Environment ID
      --force <true|false>      Force the cloud browser to stop [possible values: true, false]
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-browser connect

Connect to a cloud browser desktop

Usage: ml-cli cloud-browser connect [OPTIONS]

Options:
      --env-id <ENV_ID>         Environment ID
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone

Cloud phone management

Usage: ml-cli cloudphone [OPTIONS] <COMMAND>

Commands:
  team-app-delete                  Delete a team app record; keep installed apps and device data
  team-app-update-group            Save the preinstall range; no immediate install or uninstall
  team-app-enable                  Enable or disable preinstall; preserve other settings
  team-app-update-install-setting  Save installation strategy: 1 overwrite, 2 skip installed apps
  team-app-update-enable-root      Save team app ROOT configuration; no immediate device ROOT
  team-app-create                  Create a store team app; service owns defaults; returns team app ID
  team-app-list                    Query configured team apps, not the app market
  team-app-update-version          Save the store app target version for next cloud phone startup
  team-app-update-setting          Save one team app setting without changing the other three
  team-app-operate                 Request an app operation across eligible running phones in the install range
  list                             Getting a list of cloud phone profiles
  find                             Find cloud phones by name and print matched candidates
  open                             Find and start exactly one cloud phone by name
  close                            Find and power off exactly one cloud phone by name
  create                           Creating a Cloud Phone Profile
  edit                             Modify the cloud phone profile
  delete                           Delete cloud phone profile
  info                             Cloud phone details
  brand-models                     Query brand & model list
  update-adb
  exe-command                      Execute shell command
  power-on                         Start cloud phone
  power-off                        Power off cloud phone
  reset                            Reset cloud phone
  upload                           Upload file to cloud phone
  file-get-upload-url              Get temporary upload file URL
  file-upload-by-url               Upload file for URL
  file-upload-result               Query upload file result
  file-download                    Download file from cloud phone
  file-download-result             Query file download result
  set-keybox                       Set Keybox
  install-app                      Install custom app
  app-list                         Get APP application list
  app-installed-list               Query installed apps list
  app-start                        Launch APP
  app-restart                      Restart APP
  app-stop                         Stop APP
  app-uninstall                    Uninstall APP
  app-hide-accessibility           Set Hide Accessibility App
  help                             Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone team-app-delete

Delete a team app record; keep installed apps and device data

Usage: ml-cli cloudphone team-app-delete [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

Fields may also be provided via --json-data. IDs are team application IDs, not phone IDs. Boolean options require explicit true or false. Saves team configuration, not proof of device completion.

ml-cli cloudphone team-app-update-group

Save the preinstall range; no immediate install or uninstall

Usage: ml-cli cloudphone team-app-update-group [OPTIONS]

Options:
      --id <ID>
      --is-all <IS_ALL>         [possible values: true, false]
      --group-ids <GROUP_IDS>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

Fields may also be provided via --json-data. IDs are team application IDs, not phone IDs. Boolean options require explicit true or false. Saves team configuration, not proof of device completion.

ml-cli cloudphone team-app-enable

Enable or disable preinstall; preserve other settings

Usage: ml-cli cloudphone team-app-enable [OPTIONS]

Options:
      --id <ID>
      --enabled <ENABLED>       [possible values: true, false]
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

Fields may also be provided via --json-data. IDs are team application IDs, not phone IDs. Boolean options require explicit true or false. Saves team configuration, not proof of device completion.

ml-cli cloudphone team-app-update-install-setting

Save installation strategy: 1 overwrite, 2 skip installed apps

Usage: ml-cli cloudphone team-app-update-install-setting [OPTIONS]

Options:
      --id <ID>

      --install-setting <INSTALL_SETTING>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

Fields may also be provided via --json-data. IDs are team application IDs, not phone IDs. Boolean options require explicit true or false. Saves team configuration, not proof of device completion.

ml-cli cloudphone team-app-update-enable-root

Save team app ROOT configuration; no immediate device ROOT

Usage: ml-cli cloudphone team-app-update-enable-root [OPTIONS]

Options:
      --id <ID>
      --enable-root <ENABLE_ROOT>  [possible values: true, false]
      --port <PORT>                httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>      Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error     Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>            Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                    Print diagnostic request details to stderr
      --quiet                      Suppress successful stdout output
  -h, --help                       Print help

Fields may also be provided via --json-data. IDs are team application IDs, not phone IDs. Boolean options require explicit true or false. Saves team configuration, not proof of device completion.

ml-cli cloudphone team-app-create

Create a store team app; service owns defaults; returns team app ID

Usage: ml-cli cloudphone team-app-create [OPTIONS]

Options:
      --package-name <PACKAGE_NAME>
      --version-code <VERSION_CODE>
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

Fields may also be provided via --json-data. IDs are team application IDs, not phone IDs. Boolean options require explicit true or false. Saves team configuration, not proof of device completion.

ml-cli cloudphone team-app-list

Query configured team apps, not the app market

Usage: ml-cli cloudphone team-app-list [OPTIONS]

Options:
      --app-name <APP_NAME>
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone team-app-update-version

Save the store app target version for next cloud phone startup

Usage: ml-cli cloudphone team-app-update-version [OPTIONS]

Options:
      --id <ID>
      --package-name <PACKAGE_NAME>
      --version-code <VERSION_CODE>
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

Use a team application ID from team-app-list, not a phone ID. versionCode is an integer code, not versionName/appVersionId. Success saves configuration only, not an immediate device update. Fields may also be provided via --json-data.

ml-cli cloudphone team-app-update-setting

Save one team app setting without changing the other three

Usage: ml-cli cloudphone team-app-update-setting [OPTIONS]

Options:
      --id <ID>
      --setting-type <SETTING_TYPE>  permission/keep-alive/auto-start/hide; also accepts PERMISSION/KEEP_ALIVE/AUTO_START/HIDE (same as JSON) [possible values: permission, keep-alive, auto-start, hide]
      --enabled <ENABLED>            [possible values: true, false]
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

Use the team application ID, not a phone ID. --enabled requires true or false; omission is not disable. Success saves configuration only, not proof of device support or effect. Flags and JSON settingType accept permission/keep-alive/auto-start/hide or PERMISSION/KEEP_ALIVE/AUTO_START/HIDE; requests always use the uppercase API enum.

ml-cli cloudphone team-app-operate

Request an app operation across eligible running phones in the install range

Usage: ml-cli cloudphone team-app-operate [OPTIONS]

Options:
      --id <ID>

      --operation <OPERATION>
          start/stop/restart/uninstall; also accepts START/STOP/RESTART/UNINSTALL (same as JSON) [possible values: start, stop, restart, uninstall]
      --only-started-by-me <ONLY_STARTED_BY_ME>
          [possible values: true, false]
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

Use the team application ID, not a phone ID. Success means request issued, not device completion. Does not power on, poll, or retry. UNINSTALL deletes installed app data but retains team preinstall configuration. Flags and JSON operation accept start/stop/restart/uninstall or START/STOP/RESTART/UNINSTALL; requests always use the uppercase API enum.

ml-cli cloudphone list

Getting a list of cloud phone profiles

Usage: ml-cli cloudphone list [OPTIONS]

Options:
      --keyword <KEYWORD>
      --bind-ip <BIND_IP>       [possible values: true, false]
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone find

Find cloud phones by name and print matched candidates

Usage: ml-cli cloudphone find [OPTIONS]

Options:
      --name <NAME>             Cloud phone name or name fragment to search
      --keyword <KEYWORD>       Keyword to search by cloud phone name, group name, tag name, or remark
      --exact                   Require exact case-insensitive name match
      --page-no <PAGE_NO>       Page number to query before local matching
      --page-size <PAGE_SIZE>   Page size to query before local matching
      --limit <LIMIT>           Maximum matched candidates to print
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone open

Find and start exactly one cloud phone by name

Usage: ml-cli cloudphone open [OPTIONS]

Options:
      --name <NAME>
          Cloud phone name or name fragment to search
      --keyword <KEYWORD>
          Keyword to search by cloud phone name, group name, tag name, or remark
      --exact
          Require exact case-insensitive name match
      --page-no <PAGE_NO>
          Page number to query before local matching
      --page-size <PAGE_SIZE>
          Page size to query before local matching
      --headless <true|false>
          Display Cloud Phone window: false=display, true=do not display [possible values: true, false]
      --disable-money-saving-mode <true|false>
          Disable power saving mode [possible values: true, false]
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli cloudphone close

Find and power off exactly one cloud phone by name

Usage: ml-cli cloudphone close [OPTIONS]

Options:
      --name <NAME>             Cloud phone name or name fragment to search
      --keyword <KEYWORD>       Keyword to search by cloud phone name, group name, tag name, or remark
      --exact                   Require exact case-insensitive name match
      --page-no <PAGE_NO>       Page number to query before local matching
      --page-size <PAGE_SIZE>   Page size to query before local matching
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone create

Creating a Cloud Phone Profile

Usage: ml-cli cloudphone create [OPTIONS]

Options:
      --sku-id <SKU_ID>         Cloud phone model. 10002=Android 12, 10013=Android 13, 10005=Android 14, 10004=Android 15, 10014=Android 15A
      --quantity <QUANTITY>     Number of cloud phones to create. Range: 1-10
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone edit

Modify the cloud phone profile

Usage: ml-cli cloudphone edit [OPTIONS]

Options:
  -i, --id <ID>
      --env-name <ENV_NAME>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone delete

Delete cloud phone profile

Usage: ml-cli cloudphone delete [OPTIONS]

Options:
  -i, --ids <IDS>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone info

Cloud phone details

Usage: ml-cli cloudphone info [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone brand-models

Query brand & model list

Usage: ml-cli cloudphone brand-models [OPTIONS]

Options:
      --sku-id <SKU_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone update-adb

Usage: ml-cli cloudphone update-adb [OPTIONS]

Options:
      --enable-adb <true|false>  ADB status to apply: true=enable, false=disable [possible values: true, false]
  -i, --ids <IDS>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

Examples:
  ml-cli cloudphone update-adb --ids 1698131367043136 --enable-adb true
  ml-cli cloudphone update-adb --ids 1698131367043136 --enable-adb false
  ml-cli cloudphone update-adb --json-data '{"enableAdb":true,"ids":["1698131367043136"]}'
  ml-cli cloudphone update-adb --json-data '{"enableAdb":false,"ids":["1698131367043136"]}'

ml-cli cloudphone exe-command

Execute shell command

Usage: ml-cli cloudphone exe-command [OPTIONS]

Options:
      --id <ID>
      --command <COMMAND>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone power-on

Start cloud phone

Usage: ml-cli cloudphone power-on [OPTIONS]

Options:
      --id <ID>

      --headless <true|false>
          Display Cloud Phone window: false=display, true=do not display [possible values: true, false]
      --disable-money-saving-mode <true|false>
          Disable power saving mode [possible values: true, false]
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli cloudphone power-off

Power off cloud phone

Usage: ml-cli cloudphone power-off [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone reset

Reset cloud phone

Usage: ml-cli cloudphone reset [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone upload

Upload file to cloud phone

Usage: ml-cli cloudphone upload [OPTIONS]

Options:
      --id <ID>
      --file <FILE>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone file-get-upload-url

Get temporary upload file URL

Usage: ml-cli cloudphone file-get-upload-url [OPTIONS]

Options:
      --id <ID>
      --file-name <FILE_NAME>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone file-upload-by-url

Upload file for URL

Usage: ml-cli cloudphone file-upload-by-url [OPTIONS]

Options:
      --id <ID>
      --url <URL>
      --upload-dest <UPLOAD_DEST>
      --port <PORT>                httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>      Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error     Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>            Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                    Print diagnostic request details to stderr
      --quiet                      Suppress successful stdout output
  -h, --help                       Print help

ml-cli cloudphone file-upload-result

Query upload file result

Usage: ml-cli cloudphone file-upload-result [OPTIONS]

Options:
      --id <ID>
      --file-id <FILE_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone file-download

Download file from cloud phone

Usage: ml-cli cloudphone file-download [OPTIONS]

Options:
      --id <ID>
      --file-path <FILE_PATH>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone file-download-result

Query file download result

Usage: ml-cli cloudphone file-download-result [OPTIONS]

Options:
      --id <ID>
      --down-id <DOWN_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone set-keybox

Set Keybox

Usage: ml-cli cloudphone set-keybox [OPTIONS]

Options:
      --id <ID>
      --file-path <FILE_PATH>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone install-app

Install custom app

Usage: ml-cli cloudphone install-app [OPTIONS]

Options:
      --id <ID>

      --app-version-id <APP_VERSION_ID>

      --package-name <PACKAGE_NAME>

      --version-code <VERSION_CODE>

      --file <FILE>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli cloudphone app-list

Get APP application list

Usage: ml-cli cloudphone app-list [OPTIONS]

Options:
      --app-name <APP_NAME>
      --page-num <PAGE_NUM>
      --page-size <PAGE_SIZE>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone app-installed-list

Query installed apps list

Usage: ml-cli cloudphone app-installed-list [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloudphone app-start

Launch APP

Usage: ml-cli cloudphone app-start [OPTIONS]

Options:
      --id <ID>
      --package-name <PACKAGE_NAME>
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

ml-cli cloudphone app-restart

Restart APP

Usage: ml-cli cloudphone app-restart [OPTIONS]

Options:
      --id <ID>
      --package-name <PACKAGE_NAME>
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

ml-cli cloudphone app-stop

Stop APP

Usage: ml-cli cloudphone app-stop [OPTIONS]

Options:
      --id <ID>
      --package-name <PACKAGE_NAME>
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

ml-cli cloudphone app-uninstall

Uninstall APP

Usage: ml-cli cloudphone app-uninstall [OPTIONS]

Options:
      --id <ID>
      --package-name <PACKAGE_NAME>
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

ml-cli cloudphone app-hide-accessibility

Set Hide Accessibility App

Usage: ml-cli cloudphone app-hide-accessibility [OPTIONS]

Options:
  -i, --ids <IDS>
  -p, --package-name <PACKAGE_NAMES>
      --port <PORT>                   httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>             API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>             Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>         Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error        Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>               Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                       Print diagnostic request details to stderr
      --quiet                         Suppress successful stdout output
  -h, --help                          Print help

ml-cli group

Group management

Usage: ml-cli group [OPTIONS] <COMMAND>

Commands:
  list    List groups
  edit    Modify group
  create  Create group
  delete  Delete group
  help    Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli group list

List groups

Usage: ml-cli group list [OPTIONS]

Options:
      --group-name <GROUP_NAME>
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli group edit

Modify group

Usage: ml-cli group edit [OPTIONS]

Options:
      --id <ID>
      --group-name <GROUP_NAME>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli group create

Create group

Usage: ml-cli group create [OPTIONS]

Options:
      --group-name <GROUP_NAME>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli group delete

Delete group

Usage: ml-cli group delete [OPTIONS]

Options:
  -i, --ids <IDS>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli tag

Tag management

Usage: ml-cli tag [OPTIONS] <COMMAND>

Commands:
  list    List all tags
  edit    Modify tag
  create  Create tag
  delete  Delete tag
  help    Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli tag list

List all tags

Usage: ml-cli tag list [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli tag edit

Modify tag

Usage: ml-cli tag edit [OPTIONS]

Options:
      --id <ID>
      --tag-name <TAG_NAME>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli tag create

Create tag

Usage: ml-cli tag create [OPTIONS]

Options:
      --tag-name <TAG_NAME>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli tag delete

Delete tag

Usage: ml-cli tag delete [OPTIONS]

Options:
  -i, --ids <IDS>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli proxy

Proxy management

Usage: ml-cli proxy [OPTIONS] <COMMAND>

Commands:
  list    List proxies
  create  Add proxy
  edit    Modify proxy
  delete
  help    Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli proxy list

List proxies

Usage: ml-cli proxy list [OPTIONS]

Options:
      --page-no <PAGE_NO>

      --page-size <PAGE_SIZE>

      --is-cloud-phone-proxy <true|false>
          Whether the proxy is for cloud phone usage: true=cloud-phone only, false=all proxies [possible values: true, false]
      --proxy-category-type <PROXY_CATEGORY_TYPE>
          Proxy category type. 1=cloud platform, 2=self-owned IP
      --proxy-ip <PROXY_IP>

      --proxy-name <PROXY_NAME>

      --proxy-providers <PROXY_PROVIDERS>
          Proxy provider filter; repeat the flag for multiple values. Common values include 0=custom, 1=MoreLogin, 2=local, 16=PiaProxy, 17=922S5, 18=360Proxy
      --proxy-status <PROXY_STATUS>
          Proxy assignment status. 0=normal, 1=unassigned, 2=upgrading, 3=expired, 4=expiring-soon
      --proxy-check-status <PROXY_CHECK_STATUS>
          Proxy health check status. 0=pending, 1=success, 2=failed, 3=unknown-error
      --proxy-types <PROXY_TYPES>
          Proxy protocol filter; repeat the flag for multiple values. 0=http, 1=https, 2=socks5, 3=ssh
      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli proxy create

Add proxy

Usage: ml-cli proxy create [OPTIONS]

Options:
      --proxy-ip <PROXY_IP>

      --proxy-port <PROXY_PORT>

      --proxy-provider <PROXY_PROVIDER>
          Proxy provider. Common values include 0=custom, 1=MoreLogin, 2=local, 16=PiaProxy, 17=922S5, 18=360Proxy
      --proxy-name <PROXY_NAME>

      --proxy-type <PROXY_TYPE>
          Proxy protocol. 0=http, 1=https, 2=socks5, 3=ssh
      --username <USERNAME>

      --password <PASSWORD>

      --city <CITY>

      --country <COUNTRY>

      --state <STATE>

      --encryption-type <ENCRYPTION_TYPE>
          Proxy encryption type. Use values in the supported range 1-14 when provider requires encrypted transport
      --ip-change-action <IP_CHANGE_ACTION>
          Action when proxy IP changes. 0=block, 1=warn
      --ip-monitor <true|false>
          [possible values: true, false]
      --refresh-url <REFRESH_URL>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli proxy edit

Modify proxy

Usage: ml-cli proxy edit [OPTIONS]

Options:
      --id <ID>

      --proxy-ip <PROXY_IP>

      --proxy-port <PROXY_PORT>

      --proxy-provider <PROXY_PROVIDER>
          Proxy provider. Common values include 0=custom, 1=MoreLogin, 2=local, 16=PiaProxy, 17=922S5, 18=360Proxy
      --proxy-name <PROXY_NAME>

      --proxy-type <PROXY_TYPE>
          Proxy protocol. 0=http, 1=https, 2=socks5, 3=ssh
      --username <USERNAME>

      --password <PASSWORD>

      --city <CITY>

      --country <COUNTRY>

      --state <STATE>

      --encryption-type <ENCRYPTION_TYPE>
          Proxy encryption type. Use values in the supported range 1-14 when provider requires encrypted transport
      --ip-change-action <IP_CHANGE_ACTION>
          Action when proxy IP changes. 0=block, 1=warn
      --ip-monitor <true|false>
          [possible values: true, false]
      --refresh-url <REFRESH_URL>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli proxy delete

Usage: ml-cli proxy delete [OPTIONS]

Options:
  -i, --ids <IDS>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli schedule

Cloud Phone Schedules management

Usage: ml-cli schedule [OPTIONS] <COMMAND>

Commands:
  template-market
  template-personal
  list
  create-once-task
  cancel
  subtask-list
  subtask-detail
  subtask-cancel
  help               Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli schedule template-market

Usage: ml-cli schedule template-market [OPTIONS]

Options:
      --search-key <SEARCH_KEY>
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli schedule template-personal

Usage: ml-cli schedule template-personal [OPTIONS]

Options:
      --search-key <SEARCH_KEY>
      --desc <DESC>
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli schedule list

Usage: ml-cli schedule list [OPTIONS]

Options:
      --enabled <true|false>
          [possible values: true, false]
      --task-name <TASK_NAME>

      --template-title <TEMPLATE_TITLE>

      --task-state <TASK_STATE>
          Task state. 0=awaiting-execution, 1=executing, 2=completed, 3=cancelled
      --page-no <PAGE_NO>

      --page-size <PAGE_SIZE>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli schedule create-once-task

Usage: ml-cli schedule create-once-task [OPTIONS]

Options:
      --cloud-phone-id <CLOUD_PHONE_ID>

      --schedule-name <SCHEDULE_NAME>

      --template-id <TEMPLATE_ID>

      --template-parameter <TEMPLATE_PARAMETER>

      --description <DESCRIPTION>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli schedule cancel

Usage: ml-cli schedule cancel [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli schedule subtask-list

Usage: ml-cli schedule subtask-list [OPTIONS]

Options:
      --task-id <TASK_ID>

      --task-name <TASK_NAME>

      --task-state <TASK_STATE>

      --template-id <TEMPLATE_ID>

      --template-title <TEMPLATE_TITLE>

      --cloud-phone-id <CLOUD_PHONE_ID>

      --cloud-phone-name <CLOUD_PHONE_NAME>

      --begin-time <BEGIN_TIME>

      --end-time <END_TIME>

      --page-no <PAGE_NO>

      --page-size <PAGE_SIZE>

      --port <PORT>
          httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>
          API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>
          Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>
          Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error
          Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>
          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose
          Print diagnostic request details to stderr
      --quiet
          Suppress successful stdout output
  -h, --help
          Print help

ml-cli schedule subtask-detail

Usage: ml-cli schedule subtask-detail [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli schedule subtask-cancel

Usage: ml-cli schedule subtask-cancel [OPTIONS]

Options:
      --id <ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage

Cloud storage file and label management

Usage: ml-cli cloud-storage [OPTIONS] <COMMAND>

Commands:
  info          Query cloud storage quota and usage
  list          Page cloud storage files
  presign       Batch request presigned upload URLs
  complete      Confirm upload completion after uploading to presignedUrl
  delete        Batch delete cloud storage files
  set-labels    Set file labels, overwriting existing labels
  add-labels    Add file labels without removing existing labels
  file-labels   Query labels attached to cloud storage files
  labels        Query all cloud storage file labels
  label-create  Create a cloud storage file label
  label-update  Edit a cloud storage file label
  label-delete  Delete a cloud storage file label
  help          Print this message or the help of the given subcommand(s)

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage info

Query cloud storage quota and usage

Usage: ml-cli cloud-storage info [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage list

Page cloud storage files

Usage: ml-cli cloud-storage list [OPTIONS]

Options:
      --page-no <PAGE_NO>
      --page-size <PAGE_SIZE>
      --keyword <KEYWORD>        File name keyword for fuzzy search
      --file-type <FILE_TYPE>    File type filter. 0=image, 1=video, 2=app, 3=audio, 4=document, 5=other
      --tag-id <TAG_IDS>         Filter by tag ID; repeat for multiple tags
      --file-id <FILE_IDS>       Filter by cloud storage file ID; repeat for multiple files
      --start-time <START_TIME>  Start time as a Unix timestamp in milliseconds
      --end-time <END_TIME>      End time as a Unix timestamp in milliseconds
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli cloud-storage presign

Batch request presigned upload URLs

Usage: ml-cli cloud-storage presign [OPTIONS]

Options:
      --file-name <FILE_NAMES>
      --file-size <FILE_SIZE>        Deprecated compatibility option; ignored by the backend
      --content-type <CONTENT_TYPE>  Deprecated compatibility option; ignored by the backend
      --port <PORT>                  httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>            API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>            Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>        Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error       Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>              Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                      Print diagnostic request details to stderr
      --quiet                        Suppress successful stdout output
  -h, --help                         Print help

Upload flow:
  1. Run this command to request presigned upload URLs.
  2. Upload each file binary to the returned presignedUrl with HTTPS PUT.
  3. Run `ml-cli cloud-storage complete --id <id>` with the id returned by this command.

For multiple files, repeat --file-name or pass {"fileNames":[...]} via --json-data.

Examples:
  ml-cli cloud-storage presign --file-name video.mp4
  ml-cli cloud-storage presign --file-name a.jpg --file-name b.png
  ml-cli cloud-storage presign --json-data '{"fileNames":["a.jpg","b.png"]}'

ml-cli cloud-storage complete

Confirm upload completion after uploading to presignedUrl

Usage: ml-cli cloud-storage complete [OPTIONS]

Options:
      --id <ID>
      --upload-id <UPLOAD_ID>   Deprecated alias; mapped to id for compatibility
      --file-name <FILE_NAME>
      --file-size <FILE_SIZE>
      --label-ids <LABEL_IDS>   Label ID to attach to the uploaded file; repeat for multiple labels
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

Use the id returned by `cloud-storage presign` after the binary file has been uploaded to presignedUrl.

Examples:
  ml-cli cloud-storage complete --id 1800000000000001
  ml-cli cloud-storage complete --json-data '{"id":1800000000000001}'

ml-cli cloud-storage delete

Batch delete cloud storage files

Usage: ml-cli cloud-storage delete [OPTIONS]

Options:
  -i, --file-id <FILE_IDS>      Cloud storage file ID; repeat for multiple files
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage set-labels

Set file labels, overwriting existing labels

Usage: ml-cli cloud-storage set-labels [OPTIONS]

Options:
  -i, --file-id <FILE_IDS>      Cloud storage file ID; repeat for multiple files
  -l, --tag-id <TAG_IDS>        Tag ID to set; repeat for multiple tags. Omit only when --json-data sets tagIds
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage add-labels

Add file labels without removing existing labels

Usage: ml-cli cloud-storage add-labels [OPTIONS]

Options:
  -i, --file-id <FILE_IDS>      Cloud storage file ID; repeat for multiple files
  -l, --tag-id <TAG_IDS>        Tag ID to add; repeat for multiple tags
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage file-labels

Query labels attached to cloud storage files

Usage: ml-cli cloud-storage file-labels [OPTIONS]

Options:
  -i, --file-id <FILE_IDS>      Cloud storage file ID; repeat for multiple files
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage labels

Query all cloud storage file labels

Usage: ml-cli cloud-storage labels [OPTIONS]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli cloud-storage label-create

Create a cloud storage file label

Usage: ml-cli cloud-storage label-create [OPTIONS]

Options:
      --label-name <LABEL_NAME>
      --color <COLOR>            Label color in hex format, for example #2F80ED
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli cloud-storage label-update

Edit a cloud storage file label

Usage: ml-cli cloud-storage label-update [OPTIONS]

Options:
      --label-id <LABEL_ID>
      --label-name <LABEL_NAME>
      --color <COLOR>            Label color in hex format, for example #27AE60
      --port <PORT>              httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>        API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>        Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>    Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error   Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>          Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                  Print diagnostic request details to stderr
      --quiet                    Suppress successful stdout output
  -h, --help                     Print help

ml-cli cloud-storage label-delete

Delete a cloud storage file label

Usage: ml-cli cloud-storage label-delete [OPTIONS]

Options:
      --label-id <LABEL_ID>
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

ml-cli self-update

Update ml-cli to the latest version

Usage: ml-cli self-update [OPTIONS]

Options:
      --version <VERSION>       Target version to install; omit to query the latest-version API
      --allow-downgrade         Allow an explicit --version older than the currently running CLI
      --dry-run                 Print download URL and target path without actually updating
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

Queries the official latest-version API, rejects redirects and implicit downgrades, verifies <download-url>.sha256, and only then replaces the current binary. An explicit downgrade requires both --version and --allow-downgrade.

Examples:
  ml-cli self-update
  ml-cli self-update --version 2.7.3
  ml-cli self-update --version 2.5.0 --allow-downgrade
  ml-cli self-update --dry-run

ml-cli completions

Generate shell completion scripts

Usage: ml-cli completions [OPTIONS] <SHELL>

Arguments:
  <SHELL>  Target shell [possible values: bash, elvish, fish, powershell, zsh]

Options:
      --port <PORT>             httpServer port (auto-detected via IPC pipe by default)
      --api-key <API_KEY>       API Key (Bearer Token), can also be set via ML_API_KEY env var
      --timeout <TIMEOUT>       Request timeout in seconds (default: 15; env core-download: 1810)
      --json-data <JSON_DATA>   Optional raw JSON payload; commands with dedicated flags may merge them into this body
      --fail-on-business-error  Exit with code 1 when the JSON response contains a non-zero top-level `code`
      --format <FORMAT>         Output format for JSON API responses [default: json] [possible values: json, table]
      --verbose                 Print diagnostic request details to stderr
      --quiet                   Suppress successful stdout output
  -h, --help                    Print help

Examples:
  ml-cli completions bash > ~/.bash_completion.d/ml-cli
  ml-cli completions zsh > ~/.zfunc/_ml-cli
  ml-cli completions fish > ~/.config/fish/completions/ml-cli.fish
  ml-cli completions powershell > ml-cli.ps1