Referencia de comandos
Todos los comandos de argy, sus opciones y la forma de su salida --json.
Actualizado: 2026-11-15
Opciones globales
| Opción | Uso |
|---|---|
--site, -s <sitio> | Sitio sobre el que operar: dominio, subdominio o id. |
--json | Salida JSON en stdout; progreso en stderr. |
--api-url <url> | Portal a usar (también ARGY_API_URL). |
--help, -h | Ayuda del comando. |
Sin --site, se usa el sitio vinculado con argy link.
Cuenta
argy login [--no-browser]Inicia sesión con un código que se aprueba en el navegador. Ver «CLI de ArgyHost».
{ "email": "[email protected]", "apiUrl": "https://portal.argysolutions.com" }argy logoutRevoca el token en uso (guardado o ARGY_TOKEN) y borra las credenciales del equipo.
{ "revoked": true }argy whoamiMuestra la cuenta y el portal con los que opera el CLI.
{ "email": "[email protected]", "name": "Vos", "apiUrl": "https://portal.argysolutions.com" }Sitios
argy sites lsLista los sitios de la cuenta con su tipo, estado y último deploy. Alias: argy ls.
{
"sites": [
{
"id": "a1b2c3", "name": "mi-sitio.com.ar", "kind": "upload",
"status": "running", "live": true, "subdomain": "mi-sitio",
"domain": "mi-sitio.argysolutions.com", "customDomain": "mi-sitio.com.ar",
"phase": null, "lastDeployAt": "2026-11-15T12:00:00.000Z",
"createdAt": "2026-10-01T09:30:00.000Z", "gitRepository": null, "gitBranch": null
}
]
}argy sites inspect [sitio]Detalle de un sitio: id, tipo, estado, URL, último deploy y repositorio. Sin argumento usa --site o el vinculado. La salida --json es un elemento de sites ls.
argy sites create <subdominio> [--mode static|build] [--domain <dominio>] [--no-link]Crea un sitio que se publica subiendo archivos y vincula la carpeta actual (salvo --no-link o si ya estaba vinculada). Sin --mode, lo detecta por los archivos de la carpeta. Los sitios desde GitHub se crean en el portal.
{ "id": "a1b2c3", "domain": "mi-sitio.argysolutions.com", "uploadMode": "static", "linked": true }argy sites rm --site <sitio> --yesElimina el sitio y su contenido. No se puede deshacer; sin --yes no hace nada.
argy link <sitio>Vincula la carpeta actual al sitio (.argy/project.json).
{ "id": "a1b2c3", "name": "mi-sitio.com.ar", "path": "/ruta/.argy/project.json" }argy unlinkQuita el vínculo de la carpeta (busca .argy/ hacia arriba).
argy statusEstado en vivo: si está publicado, el estado general y cada proceso con sus reinicios y el motivo si no está listo.
{
"id": "a1b2c3", "name": "mi-sitio.com.ar", "status": "running", "published": true,
"lastDeployAt": "2026-11-15T12:00:00.000Z",
"processes": [ { "name": "web", "status": "started", "ready": true, "restarts": 0, "reason": null } ]
}argy start | argy stop | argy restartEnciende, apaga o reinicia el sitio. Salida: { "id": "a1b2c3", "action": "restart" }.
Deploys
argy deploy [carpeta] [--no-wait] [--timeout 20m]Sitios por archivos: empaqueta la carpeta (por defecto la actual) y la sube. Los estáticos quedan publicados al instante. Sitios de GitHub: construye el último commit de la rama configurada. Espera a que termine salvo --no-wait; --timeout acepta 90s, 15m o 1h. Sale con 5 si el build o el arranque fallan y con 6 si se agota el tiempo.
{ "id": "a1b2c3", "url": "https://mi-sitio.com.ar", "status": "published", "deploymentId": "6735f0…" }En sitios estáticos la salida incluye releaseId en lugar de deploymentId.
argy deployments lsÚltimos 10 deploys con estado, fecha, commit y mensaje. runtimeFailed: true indica que la versión se publicó pero la app se cae al arrancar.
argy deployments logs <id>Log completo de un deploy. Si el log podría mostrar valores de variables que no se pueden enmascarar, se oculta (restricted: true).
argy rollback <versión>Solo sitios estáticos: vuelve a publicar una versión anterior por su releaseId (lo devuelve argy deploy --json). Se conservan las 3 últimas versiones.
Logs
argy logs [--lines 200] [--follow]Salida estándar y de error de la app en ejecución (10 a 500 líneas). --follow consulta cada 3 segundos hasta Ctrl+C; con --json emite un objeto { "line": … } por línea. Los valores de las variables aparecen como •••.
Variables de entorno
argy env lsLista las variables sin sus valores: clave, si se usa en el build, si es de la plataforma y si el valor es recuperable (public, stored o unknown).
argy env get <CLAVE>Imprime el valor tal cual (útil para $(argy env get CLAVE)).
argy env set <CLAVE> [valor|-] [--build] [--no-restart]Crea o actualiza una variable. Sin valor (o con -) lo lee de stdin, para que no quede en el historial: printf %s "$VALOR" | argy env set CLAVE.
{ "key": "API_KEY", "restarted": true }argy env rm <CLAVE> [--no-restart]Borra una variable. Las de la plataforma no se pueden borrar.
argy env pull [archivo] [--yes]Escribe las variables recuperables en un .env (por defecto .env.local, permisos 0600). No pisa un archivo existente sin --yes.
{ "path": "/ruta/.env.local", "written": ["API_KEY"], "skipped": ["TSURU_APPNAME"] }argy env push <archivo> [--build] [--no-restart]Crea o actualiza todas las variables de un .env (acepta export, comillas y comentarios). Las que no están en el archivo no se tocan. Reinicia una sola vez.
{ "created": 3, "updated": 1, "restarted": true }Dominios
argy domains add <dominio>Conecta un dominio propio y pide el certificado HTTPS.
{ "id": "a1b2c3", "domain": "www.mi-sitio.com.ar" }argy domains rmDesconecta el dominio propio; el sitio vuelve a su subdominio. Devuelve el dominio activo.