Comandos de la CLI
Todos los comandos `skiffly` con sus flags. Los flags globales de destino `-p/--project`, `-e/--environment`, `-s/--service` aceptan un id o un nombre.
Instala con npm i -g skiffly (Node.js 20+). La guía de la CLI recorre el flujo de trabajo; esta página es la lista completa.
Autenticación#
| Comando | Descripción |
|---|---|
login [--token <t>] [--browserless] | Inicia sesión desde el navegador (código de emparejamiento) o guarda un token de espacio de trabajo; se almacena en ~/.config/skiffly/config.json |
logout | Revoca el token de la cuenta en el servidor y lo olvida localmente |
whoami | Usuario actual y espacios de trabajo |
Proyectos y vinculación#
| Comando | Descripción |
|---|---|
list | Proyectos de todos tus espacios de trabajo |
init [--name <n>] [--workspace <id>] | Crea un proyecto y vincula el directorio actual |
link [project] [-p] [-e] [-s] | Vincula el directorio a un proyecto / entorno / servicio |
unlink | Elimina el vínculo |
status | Destino vinculado más el estado de despliegue y los dominios de cada servicio |
open [--print] | Abre el proyecto o servicio vinculado en el panel |
environment [name] | Cambia el entorno vinculado |
environment list | Lista los entornos |
environment new <name> [--duplicate <env>] [--link] | Crea un entorno, opcionalmente copiando variables y configuración; --link vincula el directorio a él |
service [name] | Vincula un servicio |
service list | Lista los servicios |
service delete | Elimina el servicio vinculado |
Desplegar#
| Comando | Descripción |
|---|---|
up [path] [-d] [-c] [-y] [--git] [--commit <sha>] | Sube el directorio y lo construye; --git construye en su lugar el HEAD ya enviado (push) de la rama desde GitHub (--commit elige un commit), -d no espera al resultado, -c solo logs de build, -y crea el servicio sin preguntar |
redeploy [-d] [-y] | Vuelve a desplegar el commit del último despliegue con la configuración actual |
restart | Reinicia los contenedores sin reconstruir |
deploy --image <image> [--name <n>] [--port <p>] [-v K=V …] | Crea un servicio de imagen, o cambia la imagen del servicio vinculado |
deploy --template <code> [-v K=V] [-v Service.K=V] | Despliega una plantilla |
deploy-template <code> … | Alias del anterior |
deployment list [-n <N>] | Despliegues recientes |
Importar#
| Comando | Descripción |
|---|---|
import --from-railway [--railway-token <t>] [--railway-project <id>] [-p <project|new>] [-w <workspace>] [-e <env>] [--dry-run] [-y] | Copia un proyecto de Railway (servicios, variables, volúmenes, dominios, proxies TCP) a Skiffly; ver Migrar desde Railway |
Logs y shell#
| Comando | Descripción |
|---|---|
logs [deploymentId] [-b|--build] [-d|--deploy] [--system] [-f] [-n <N>] [--filter <text>] | Logs; -f consulta cada 2 s |
ssh [-s] [-e] [--deployment <id>] [-T] [-- cmd…] | Shell o comando único en un contenedor en ejecución; -T sin pseudoterminal |
shell | Alias de ssh |
run [-s] [-e] -- <cmd> | Ejecuta un comando local con las variables del servicio en el entorno |
Variables#
| Comando | Descripción |
|---|---|
variables [list] [--kv] [--shared] | Lista (alias variable, vars, var) |
variables set K=V … [--stdin K] [--shared] [--skip-deploys] | Define; vuelve a desplegar salvo con --skip-deploys |
variables delete K … | Elimina |
Redes#
| Comando | Descripción |
|---|---|
domain | Genera un dominio *.skiffly.cloud (o imprime el existente) |
domain <custom.domain> | Agrega un dominio propio; imprime los registros CNAME y TXT |
domain list | Dominios del servicio |
domain status <domain> | Vuelve a comprobar el DNS y la verificación |
domain delete <domain> | Elimina un dominio |
proxy list | Proxies TCP |
proxy add --port <p> | Expone un puerto del contenedor en edge.skiffly.cloud:2xxxx |
proxy delete <id|port> | Elimina un proxy |
connect [service] [-y] [--print] | Abre psql / mysql / redis-cli / mongosh a través de un proxy |
Volúmenes, respaldos, plantillas, facturación#
| Comando | Descripción |
|---|---|
volume list | Volúmenes del entorno |
volume add --mount-path <path> [--size <GB>] [--name <n>] | Crea un volumen en el servicio vinculado |
backups list [-v <volume>] [--sync] | Respaldos de un volumen y la programación de la plataforma |
backups create [-v <volume>] [-n <name>] | Respalda un volumen ahora (archivos, más un volcado para Postgres/MySQL) |
backups restore [backupId] [-v <volume>] [-y] | Restaura un volumen desde un respaldo (reemplaza los datos actuales; antes se hace un respaldo de seguridad) |
templates [search] [--category <c>] [--featured] | Explora el catálogo |
billing (alias usage) | Saldo, plan, uso actual |
Configuración como código#
| Comando | Descripción |
|---|---|
config init | Escribe .skiffly/skiffly.ts a partir del entorno vinculado |
config validate | Evalúa el archivo sin llamadas a la API |
config plan [--prune] [--json] [--show-secrets] [-f <file>] | Previsualiza el diff |
config apply [--yes] [--prune] [--no-deploy] [-f <file>] | Aplica el diff y despliega los servicios modificados |
MCP, docs, API directa#
| Comando | Descripción |
|---|---|
mcp | Ejecuta el servidor MCP por stdio |
mcp tools | Imprime la lista de herramientas |
mcp install claude|cursor|codex | Registra el servidor en el cliente |
docs [query] | Abre la documentación, o busca en la documentación incluida |
api '<query>' [-v '<json>'] | Solicitud GraphQL directa con el token guardado |
Variables de entorno#
| Variable | Significado |
|---|---|
SKIFFLY_TOKEN | Token; tiene prioridad sobre la sesión guardada |
SKIFFLY_PROJECT_TOKEN | Token de proyecto (un entorno de un proyecto, CI); se usa cuando SKIFFLY_TOKEN no está definido — no hace falta skiffly link |
SKIFFLY_PROJECT_ID, SKIFFLY_ENVIRONMENT_ID, SKIFFLY_SERVICE_ID | Tienen prioridad sobre el vínculo del directorio |
SKIFFLY_API_URL | Endpoint GraphQL (por defecto https://api.skiffly.dev/graphql) |
SKIFFLY_CONFIG_DIR, XDG_CONFIG_HOME | Dónde vive el archivo de configuración |
SKIFFLY_DEBUG=1 | Stack traces en los errores |
Códigos de salida#
0 ok · 1 error · 2 uso incorrecto o sin vínculo · 3 sin autenticar · 4 no encontrado · 5 prohibido o límite del plan · 6 red. Todo comando de listado admite --json.