Proton Runner CLI
O Proton Runner CLI é o runner em linha de comando, para servidores, contêineres e máquinas sem interface gráfica. Ele tem o mesmo núcleo do Proton Runner: recebe as execuções, prepara os projetos e roda as automações do mesmo jeito.
Instalar
Requer o Node.js 22 ou mais novo. Funciona no Windows, no Linux e no macOS.
npm install -g @atomicsolutions/proton5-cli
Conectar
proton config add
O comando pergunta o servidor (https://app.protoncloud.com.br), o identificador da conta e a
senha, confere as credenciais e descobre a organização. A senha vai para o cofre do sistema operacional, nunca para o
arquivo de configuração.
proton connect
O connect sobe o runner em segundo plano: fechar o terminal não derruba o runner.
Num script ou num pipeline, passe tudo de uma vez. Com --tenant, a organização vai junto, para a conta que participa de
mais de uma:
proton config add --server https://app.protoncloud.com.br --email <identificador> --password <senha> --tenant "<organização>"
Não deixe a senha escrita no script: leia de um segredo do pipeline.
Comandos do dia a dia
| Comando | O que faz |
|---|---|
proton runner status | Mostra a conexão, a organização e o status |
proton watch | Acompanha as execuções ao vivo |
proton runner stop-run | Para uma execução |
proton devices | Lista os aparelhos Android que a máquina enxerga |
proton config list | Lista as conexões cadastradas |
proton config tenant "<conexão>" --list | Lista as organizações da conta |
proton disconnect | Encerra a sessão |
proton start abre um modo interativo, com comandos de barra como /status, /runs e /devices.
Atualizar
npm install -g @atomicsolutions/proton5-cli@latest
Depois, proton disconnect e proton connect para a versão nova assumir.