Proton Runner CLI
El Proton Runner CLI es el runner en línea de comandos, para servidores, contenedores y máquinas sin interfaz gráfica. Tiene el mismo núcleo que el Proton Runner: recibe las ejecuciones, prepara los proyectos y ejecuta las automatizaciones de la misma manera.
Instalar
Requiere Node.js 22 o más reciente. Funciona en Windows, Linux y macOS.
npm install -g @atomicsolutions/proton5-cli
Conectar
proton config add
El comando pide el servidor (https://app.protoncloud.com.br), el identificador de la cuenta y la
contraseña, verifica las credenciales y descubre la organización. La contraseña va al almacén seguro del sistema
operativo, nunca al archivo de configuración.
proton connect
El connect levanta el runner en segundo plano: cerrar la terminal no detiene el runner.
En un script o en un pipeline, pasa todo de una vez. Con --tenant, la organización va incluida, para la cuenta que
participa en más de una:
proton config add --server https://app.protoncloud.com.br --email <identificador> --password <senha> --tenant "<organização>"
No dejes la contraseña escrita en el script: léela de un secreto del pipeline.
Comandos del día a día
| Comando | Qué hace |
|---|---|
proton runner status | Muestra la conexión, la organización y el estado |
proton watch | Sigue las ejecuciones en vivo |
proton runner stop-run | Detiene una ejecución |
proton devices | Lista los dispositivos Android que ve la máquina |
proton config list | Lista las conexiones registradas |
proton config tenant "<conexão>" --list | Lista las organizaciones de la cuenta |
proton disconnect | Cierra la sesión |
proton start abre un modo interactivo, con comandos de barra como /status, /runs y /devices.
Actualizar
npm install -g @atomicsolutions/proton5-cli@latest
Después, ejecuta proton disconnect y proton connect para que la versión nueva entre en vigor.