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 --versionSin 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-browsery 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.
| Sistema | Dó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 deployargy 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 HTTPSargy 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
.gitignorey.argyignore(misma sintaxis) de la raíz. - Nunca se suben
node_modules,.git,.next,.vercel,.turbo,.venv,__pycache__,.DS_Storeni.argy. - Nunca se suben archivos
.envni.env.*, aunque el proyecto intente incluirlos..env.examplesí 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ódigo | Significado |
|---|---|
| 0 | Terminó bien. |
| 1 | Error general o del portal (reintentar puede servir). |
| 2 | Uso incorrecto: comando, opción o argumento inválido. |
| 3 | Sin sesión o sesión vencida: hace falta argy login o ARGY_TOKEN. |
| 4 | No existe el sitio, la variable o el recurso pedido. |
| 5 | El deploy falló (build o arranque). |
| 6 | Se 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 ;;
esacIntegració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 --jsonEse 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
| Variable | Uso |
|---|---|
ARGY_TOKEN | Token a usar en lugar del guardado (CI, agentes). |
ARGY_API_URL | Portal a usar. Por defecto https://portal.argysolutions.com. |
ARGY_CONFIG_DIR | Carpeta de configuración (por ejemplo, para separar cuentas). |
ARGY_DEBUG | Con cualquier valor, muestra el stack de errores inesperados. |
Problemas frecuentes
| Mensaje | Qué hacer |
|---|---|
| Necesitás iniciar sesión / Tu sesión venció | Corré argy login. |
| No sabemos sobre qué sitio operar | Pasá --site o corré argy link <sitio>. |
| La suscripción requiere regularización | Revisá el plan en el portal: las acciones de escritura quedan bloqueadas. |
| Ya hay una publicación en curso | Esperá a que termine (argy status) y repetí. |
| El portal respondió con un formato inesperado | Actualizá: npm install -g @argysolutions/cli@latest. |
| El proyecto comprimido supera 200 MB | Excluí archivos pesados con .argyignore. |