# Webgune CLI

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

# Webgune CLI

The official `webgune` CLI lets you manage your projects, services, deployments, and invoices directly from the terminal.

## Installation

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

Node.js 18 or higher is required.

## Authentication

```bash
webgune login
```

Without options, `webgune login` opens your browser, as the VS Code extension does, to authorize the CLI on your logged-in account. An **API key** (prefix `wgk_`) is created automatically with the necessary scopes (`projects`, `services`, `domains:read`, `billing`) and returned to the CLI via a local server (`127.0.0.1`). Nothing to copy-paste.

For scripted use (CI, browserless container), pass an existing key directly. Create it in the dashboard under **Settings → API keys**:

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

The key is stored in `~/.webgune/config.json`. You can also use environment variables, convenient in CI:

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

## Commands

### Projects

```bash
webgune projects list
webgune projects create mon-projet
webgune projects delete <id>
```

### Services

```bash
webgune services list                    # all your services
webgune services list --project <id>    # filtered by project
webgune services info <id>              # full details
webgune services logs <id> --tail 500   # runtime logs
webgune services redeploy <id>          # rebuild + redeploy
webgune services restart <id>
webgune services stop <id>
webgune services start <id>
```

### Deployments

```bash
webgune services deployments <id>                 # history
webgune services rollback <serviceId> <deployId>  # rollback
```

### Billing

```bash
webgune billing plans                    # pricing grid
webgune billing subscription             # your subscriptions (account + per-project dedicated) and SEPA mandate status
webgune billing invoices                 # your invoices
webgune billing cancel                   # cancel the account subscription (effective at end of period)
webgune billing cancel --project <id>    # cancel a project-dedicated subscription
```

In accordance with the [Terms of Service](/tos), cancelling a plan takes effect **at the end of the already-paid period**. Your services remain active until then. Cancellation is refused if an invoice is pending payment.

### Domains

```bash
webgune domains list
```

## JSON output

All listing commands accept `--json` for raw output usable in scripts:

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

## See also

- [MCP server](/docs/mcp): control webgune from Claude or any MCP client.
- [API reference](/docs/reference-api): the underlying HTTP API.