Visão geral da CLI

ml-cli é uma interface de linha de comando para o httpServer local do MoreLogin. Ele traduz argumentos CLI em solicitações HTTP e os encaminha para as APIs locais expostas pelo cliente MoreLogin.

Para quem é? Engenheiros de DevOps, engenheiros de automação de controle de qualidade e desenvolvedores que preferem trabalhar no terminal ou precisam integrar o MoreLogin em pipelines de CI/CD (como GitHub Actions, Jenkins ou scripts de shell).

O que isso pode fazer?

• Chame APIs locais MoreLogin diretamente de um terminal sem escrever código de solicitação HTTP.
• Gerencie ambientes de navegador, proxies, telefones em nuvem e programações a partir de uma interface unificada.
• Use sinalizadores CLI estáveis ​​em vez de criar manualmente cargas JSON.

Como começar?

1. Leia os Pré-requisitos abaixo.
2. Baixe e instale a CLI para sua plataforma.
3. Verifique o Início rápido para executar seu primeiro comando.

Antes de usar ml-cli, certifique-se de que os seguintes requisitos sejam atendidos:

• O cliente de desktop MoreLogin está instalado e em execução na mesma máquina
• Você tem uma conta MoreLogin ativa com credenciais de API (API ID + API Key)

Baixe o binário ml-cli mais recente para sua plataforma:

1. Crie um diretório para a CLI, por exemplo C:\Program Files\MoreLogin\:

   New-Item -ItemType Directory -Force -Path "C:\Program Files\MoreLogin"

2. Mova o ml-cli.exe baixado para esse diretório.

3. Adicione o diretório ao seu sistema PATH:

   # Add to the current user's PATH permanently
   $currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
   [Environment]::SetEnvironmentVariable("Path", "$currentPath;C:\Program Files\MoreLogin", "User")

4. Reinicie seu terminal (ou abra um novo) para que a alteração tenha efeito.

5. Verificar:

   ml-cli --version

1. Torne o binário executável:

   chmod +x ml-cli

2. Mova-o para um diretório em seu PATH:

   sudo mv ml-cli /usr/local/bin/

   Se /usr/local/bin não existir, crie-o primeiro: sudo mkdir -p /usr/local/bin

3. No macOS, o binário baixado pode ser bloqueado pelo Gatekeeper. Remova o atributo de quarentena:

   xattr -d com.apple.quarantine /usr/local/bin/ml-cli

4. Verifique:

   ml-cli --version

1. Torne o binário executável:

   chmod +x ml-cli

2. Mova-o para um diretório em seu PATH:

   sudo mv ml-cli /usr/local/bin/

3. Verifique:

   ml-cli --version

Depois de instalado, consulte Início rápido para conectar-se ao cliente MoreLogin e executar seu primeiro comando.

A CLI atual abrange estes grupos de recursos:

• status do serviço e login
• gerenciamento do ambiente do navegador via env
• gerenciamento de telefone na nuvem via cloudphone
• gerenciamento de grupo via group
• gerenciamento de tags via tag
• gerenciamento de proxy via proxy
• gerenciamento de agendamento de telefone na nuvem via schedule

A CLI oferece suporte a dois estilos de entrada:

• sinalizadores explícitos, como --env-id ou --group-name
• JSON bruto via --json-data

Eles podem ser combinados. As regras de mesclagem são:

• --json-data fornece o corpo da solicitação base
• sinalizadores CLI explícitos substituem chaves correspondentes de --json-data

Isso é útil para endpoints com muitos campos ou cargas aninhadas onde sinalizadores dedicados seriam muito pesados.

A CLI precisa encontrar a porta httpServer local para enviar solicitações. Ele verifica nesta ordem:

1. Sinalizador --port – passe explicitamente a porta em cada chamada
2. Variável de ambiente ML_PORT — definida uma vez por sessão
3. Descoberta automática de IPC — a CLI lê a porta de um canal IPC local (nenhuma configuração necessária)

Caminhos IPC padrão:

Se você vir o erro "Não foi possível detectar a porta MoreLogin", verifique:

• O cliente de desktop MoreLogin está em execução?
• Se estiver usando --port, o número da porta está correto?
• No Linux/macOS, /tmp/MoreLogin-cli existe?

• Início rápido
• Comandos