Referencia de comandos

Todos los comandos de argy, sus opciones y la forma de su salida --json.

Actualizado: 2026-11-15

Opciones globales

OpciónUso
--site, -s <sitio>Sitio sobre el que operar: dominio, subdominio o id.
--jsonSalida JSON en stdout; progreso en stderr.
--api-url <url>Portal a usar (también ARGY_API_URL).
--help, -hAyuda 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 logout

Revoca el token en uso (guardado o ARGY_TOKEN) y borra las credenciales del equipo.

{ "revoked": true }
argy whoami

Muestra la cuenta y el portal con los que opera el CLI.

{ "email": "[email protected]", "name": "Vos", "apiUrl": "https://portal.argysolutions.com" }

Sitios

argy sites ls

Lista 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> --yes

Elimina 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 unlink

Quita el vínculo de la carpeta (busca .argy/ hacia arriba).

argy status

Estado 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 restart

Enciende, 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 ls

Lista 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 rm

Desconecta el dominio propio; el sitio vuelve a su subdominio. Devuelve el dominio activo.