CLI de ArgyHost

Instalá argy, iniciá sesión y operá tus sitios desde la terminal, scripts o agentes.

Actualizado: 2026-11-15

Instalación

El CLI se publica en npm como @argysolutions/cli y necesita Node.js 20.16 o posterior. Funciona en macOS, Linux y Windows.

npm install -g @argysolutions/cli
argy --version

Sin instalarlo globalmente: npx @argysolutions/cli <comando>.

Iniciar sesión

argy login
  • La terminal muestra un código de 8 caracteres y abre el portal en el navegador.
  • En el portal (con tu sesión y tu segundo factor, si lo usás) comprobás que el código coincida y tocás Aprobar.
  • El CLI recibe el token y lo guarda solo para tu usuario (permisos 0600).
  • El código vence a los 10 minutos. Si estás en un servidor sin navegador, usá argy login --no-browser y abrí el enlace en cualquier dispositivo.

Aprobá solo códigos que estés viendo en tu propia terminal. Nadie de ArgySolutions te va a pedir que apruebes un código.

SistemaDónde se guarda el token
macOS y Linux~/.config/argy/credentials.json (o $XDG_CONFIG_HOME/argy)
Windows%APPDATA%\argy\credentials.json
Cualquiera$ARGY_CONFIG_DIR/credentials.json si definís esa variable

El token es una sesión de tu cuenta, con los mismos permisos que el portal. Dura 7 días y se renueva sola mientras el CLI la use. argy whoami muestra la cuenta activa y argy logout revoca el token y lo borra del equipo.

Vincular una carpeta a un sitio

Los comandos operan sobre un sitio. Indicalo con --site <sitio> (dominio, subdominio o id) o vinculá la carpeta del proyecto una vez:

cd mi-proyecto
argy link mi-sitio.com.ar
argy deploy

argy link guarda .argy/project.json. Los comandos lo buscan en la carpeta actual y en las superiores. Agregá .argy/ a tu .gitignore.

Del código a un sitio publicado

cd mi-proyecto
argy sites create mi-proyecto      # crea mi-proyecto.argysolutions.com y vincula la carpeta
argy env push .env.production      # carga las variables (no se suben archivos .env)
argy deploy                        # sube, construye y espera a que quede publicado
argy domains add www.mi-sitio.com  # conecta el dominio propio con HTTPS

argy sites create detecta el tipo: con un index.html en la raíz y sin package.json ni Dockerfile crea un sitio estático; si no, uno con build. Podés forzarlo con --mode static o --mode build.

Qué archivos se suben

  • Todo el contenido de la carpeta, salvo lo que ignoren .gitignore y .argyignore (misma sintaxis) de la raíz.
  • Nunca se suben node_modules, .git, .next, .vercel, .turbo, .venv, __pycache__, .DS_Store ni .argy.
  • Nunca se suben archivos .env ni .env.*, aunque el proyecto intente incluirlos. .env.example sí se sube.
  • Los enlaces simbólicos se omiten (el CLI avisa cuáles): subí el archivo real.
  • El paquete comprimido no puede superar 200 MB.

Uso desde scripts y agentes

Con --json, cada comando escribe en stdout un único documento JSON; el progreso y los avisos van a stderr. Los errores también salen como JSON:

{
  "error": {
    "message": "No encontramos el sitio \"demo\" en tu cuenta.",
    "hint": "Mirá tus sitios con `argy sites ls`."
  }
}

Un agente debería decidir por el código de salida, no por el texto:

CódigoSignificado
0Terminó bien.
1Error general o del portal (reintentar puede servir).
2Uso incorrecto: comando, opción o argumento inválido.
3Sin sesión o sesión vencida: hace falta argy login o ARGY_TOKEN.
4No existe el sitio, la variable o el recurso pedido.
5El deploy falló (build o arranque).
6Se agotó el tiempo de espera; el deploy puede seguir en curso.
argy deploy --site mi-sitio.com.ar --json > resultado.json
case $? in
  0) echo "publicado" ;;
  5) argy deployments ls --site mi-sitio.com.ar --json ;;
  6) argy status --site mi-sitio.com.ar --json ;;
esac

Integración continua

En CI no hay navegador: definí ARGY_TOKEN como secreto. El valor es el campo token de credentials.json después de un argy login. ARGY_TOKEN tiene prioridad sobre el token guardado.

- name: Publicar en ArgyHost
  env:
    ARGY_TOKEN: ${{ secrets.ARGY_TOKEN }}
  run: npx @argysolutions/cli deploy --site mi-sitio.com.ar --json

Ese token tiene todos los permisos de tu cuenta y vence si pasan 7 días sin uso. Para revocarlo: ARGY_TOKEN=<token> argy logout.

Variables de entorno del CLI

VariableUso
ARGY_TOKENToken a usar en lugar del guardado (CI, agentes).
ARGY_API_URLPortal a usar. Por defecto https://portal.argysolutions.com.
ARGY_CONFIG_DIRCarpeta de configuración (por ejemplo, para separar cuentas).
ARGY_DEBUGCon cualquier valor, muestra el stack de errores inesperados.

Problemas frecuentes

MensajeQué hacer
Necesitás iniciar sesión / Tu sesión vencióCorré argy login.
No sabemos sobre qué sitio operarPasá --site o corré argy link <sitio>.
La suscripción requiere regularizaciónRevisá el plan en el portal: las acciones de escritura quedan bloqueadas.
Ya hay una publicación en cursoEsperá a que termine (argy status) y repetí.
El portal respondió con un formato inesperadoActualizá: npm install -g @argysolutions/cli@latest.
El proyecto comprimido supera 200 MBExcluí archivos pesados con .argyignore.