# CLI Webgune

Source : https://webgune.cloud/es-es/docs/cli · Mis à jour le 2026-10-27

# CLI Webgune

El CLI oficial `webgune` te permite gestionar tus proyectos, servicios, despliegues y facturas directamente desde el terminal.

## Instalación

```bash
bun add -g webgune
# o
npm install -g webgune
```

Se requiere Node.js 18 o superior.

## Autenticación

```bash
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**:

```bash
webgune login --key wgk_xxxxxxxx
```

La clave se guarda en `~/.webgune/config.json`. También puedes usar variables de entorno, prácticas en CI:

```bash
export WEBGUNE_API_KEY=wgk_xxxxxxxx
export WEBGUNE_API_URL=https://api.webgune.cloud   # opcional
```

## Comandos

### Proyectos

```bash
webgune projects list
webgune projects create mi-proyecto
webgune projects delete <id>
```

### Servicios

```bash
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

```bash
webgune services deployments <id>                 # historial
webgune services rollback <serviceId> <deployId>  # marcha atrás
```

### Facturación

```bash
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](/tos), 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

```bash
webgune domains list
```

## Salida JSON

Todos los comandos de listado aceptan `--json` para una salida bruta utilizable en scripts:

```bash
webgune services list --json | jq '.[].name'
```

## Ver también

- [Servidor MCP](/docs/mcp): controla webgune desde Claude o cualquier cliente MCP.
- [Referencia de la API](/docs/reference-api): la API HTTP subyacente.