@janiscommerce/artie-cli

CLI para operar Artie desde la terminal: crear artefactos, subir versiones, listar y borrar — las mismas funcionalidades que la web (/me, /upload), autenticando con el IdP de Janis.

Funciona en macOS, Linux y Windows (Node ≥ 22, sin build step).

Instalación

npm i -g @janiscommerce/artie-cli

Antes del primer uso, iniciá sesión (abre el browser para autenticar con el IdP y guarda la sesión localmente):

artie login

Uso

artie whoami                      # quién sos en la sesión actual
artie list                        # lista tus artefactos
artie versions <slug>             # versiones de un artefacto
artie get <slug>                  # descarga el artefacto a disco e imprime la ruta local
artie get <slug> -v 1             # una versión específica
artie get <slug> -o ./dir         # a una carpeta puntual (default: cache local)

artie create demo.html -t "Demo"  # crea un artefacto nuevo (v1)
artie create site.zip -s mi-demo  # con slug propio (default: derivado del título)
artie create ./dist               # empaqueta el directorio (su contenido en la raíz)
artie create index.html app.js    # empaqueta varios archivos en un bundle
artie update -s mi-demo demo.html # sube una nueva versión

artie rename <slug> "Nuevo título"
artie remove <slug>               # (alias: rm) pide confirmación (-y para saltarla)
artie open <slug>                 # abre la última versión en el browser
artie logout

Leer / descargar un artefacto

artie get <slug> baja el contenido original del artefacto (el index.html o el bundle.zip, descomprimido) a disco e imprime la ruta local en stdout, en vez de volcar el contenido. Pensado para inspeccionarlo o buscar adentro con grep/editor sin cargarlo entero. Podés bajar cualquier artefacto al que tengas acceso (con isDev), no solo los tuyos. Por defecto cachea en ~/.cache/artie/<slug>/v<N>/ (reusa versiones ya bajadas; --force re-descarga).

Qué se sube

create y update aceptan uno o varios paths:

• 1 archivo .html/.htm o .zip → se sube tal cual.
• 1 directorio → se empaqueta su contenido en la raíz del zip.
• Varios paths → se empaquetan (cada archivo por su nombre en la raíz; cada directorio bajo su propio nombre).

Al empaquetar, el .zip se genera en el tmp del sistema (con yazl) y se borra tras subirlo. El bundle debe tener un index.html en la raíz (lo valida el CLI antes de subir; el expander valida el resto: máx. 200 archivos, 50 MB, etc.).

Feedback durante la subida: generando bundle… → subiendo… → publicando… → ok/error.

--no-wait en create/update no espera la publicación (útil en CI).