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>] | Guarda un token (lo pide si se omite) en ~/.config/skiffly/config.json |
logout | Olvida el token |
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>] | Crea un entorno, opcionalmente copiando variables y configuración |
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] [--commit <sha>] | Despliega el HEAD pusheado de la rama actual; -d se desconecta, -y crea el servicio sin preguntar |
redeploy | Vuelve a ejecutar el último build |
restart | Reinicia los contenedores en su lugar |
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 | Despliegues recientes |
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, plantillas, facturación#
| Comando | Descripción |
|---|---|
volume list | Volúmenes del entorno |
volume add --mount-path <path> [--size <GB>] | Crea un volumen en el servicio vinculado |
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_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.