CLI Webgune
CLI Webgune
El CLI oficial webgune te permite gestionar tus proyectos, servicios, despliegues y facturas directamente desde el terminal.
Instalación
bun add -g webgune
# o
npm install -g webgune
Se requiere Node.js 18 o superior.
Autenticación
webgune login
Sin opciones, webgune login abre tu navegador, como lo hace la extensión de VS Code, para autorizar el CLI en tu cuenta conectada. Se crea automáticamente una clave de API (prefijo wgk_) con los scopes necesarios (projects, services, domains:read, billing) y se devuelve al CLI mediante un servidor local (127.0.0.1). Nada que copiar y pegar.
Para un uso scripteado (CI, contenedor sin navegador), pasa una clave existente directamente. Créala en el dashboard, Configuración → Claves de API:
webgune login --key wgk_xxxxxxxx
La clave se guarda en ~/.webgune/config.json. También puedes usar variables de entorno, prácticas en CI:
export WEBGUNE_API_KEY=wgk_xxxxxxxx
export WEBGUNE_API_URL=https://api.webgune.cloud # opcional
Comandos
Proyectos
webgune projects list
webgune projects create mi-proyecto
webgune projects delete <id>
Servicios
webgune services list # todos tus servicios
webgune services list --project <id> # filtrados por proyecto
webgune services info <id> # detalles completos
webgune services logs <id> --tail 500 # logs de ejecución
webgune services redeploy <id> # rebuild + redespliegue
webgune services restart <id>
webgune services stop <id>
webgune services start <id>
Despliegues
webgune services deployments <id> # historial
webgune services rollback <serviceId> <deployId> # marcha atrás
Facturación
webgune billing plans # tabla de precios
webgune billing subscription # tus suscripciones (cuenta + dedicadas por proyecto) y el estado del mandato SEPA
webgune billing invoices # tus facturas
webgune billing cancel # cancelación de la suscripción de la cuenta (efecto al final del período)
webgune billing cancel --project <id> # cancelación de una suscripción dedicada a un proyecto
Conforme a las Condiciones Generales de Servicio, la cancelación de un plan tiene efecto al final del período ya pagado. Tus servicios permanecen activos hasta entonces. La cancelación se rechaza si hay una factura pendiente de pago.
Dominios
webgune domains list
Salida JSON
Todos los comandos de listado aceptan --json para una salida bruta utilizable en scripts:
webgune services list --json | jq '.[].name'
Ver también
- Servidor MCP: controla webgune desde Claude o cualquier cliente MCP.
- Referencia de la API: la API HTTP subyacente.