Webgune CLI
Webgune CLI
Das offizielle CLI webgune ermöglicht es Ihnen, Ihre Projekte, Dienste, Deployments und Rechnungen direkt vom Terminal aus zu verwalten.
Installation
bun add -g webgune
# oder
npm install -g webgune
Node.js 18 oder höher ist erforderlich.
Authentifizierung
webgune login
Ohne Option öffnet webgune login Ihren Browser, wie die VS Code-Erweiterung, um das CLI für Ihr angemeldetes Konto zu autorisieren. Ein API-Schlüssel (Präfix wgk_) wird automatisch mit den erforderlichen Scopes erstellt (projects, services, domains:read, billing) und über einen lokalen Server (127.0.0.1) an das CLI zurückgegeben. Nichts zu kopieren/einzufügen.
Für einen skriptgesteuerten Einsatz (CI, Container ohne Browser), geben Sie direkt einen bestehenden Schlüssel an. Erstellen Sie ihn im Dashboard unter Einstellungen → API-Schlüssel:
webgune login --key wgk_xxxxxxxx
Der Schlüssel wird in ~/.webgune/config.json gespeichert. Sie können auch Umgebungsvariablen verwenden, praktisch in CI:
export WEBGUNE_API_KEY=wgk_xxxxxxxx
export WEBGUNE_API_URL=https://api.webgune.cloud # optional
Befehle
Projekte
webgune projects list
webgune projects create mein-projekt
webgune projects delete <id>
Dienste
webgune services list # alle Ihre Dienste
webgune services list --project <id> # gefiltert nach Projekt
webgune services info <id> # vollständige Details
webgune services logs <id> --tail 500 # Ausführungslogs
webgune services redeploy <id> # Rebuild + Redeployment
webgune services restart <id>
webgune services stop <id>
webgune services start <id>
Deployments
webgune services deployments <id> # Historie
webgune services rollback <serviceId> <deployId> # Rollback
Abrechnung
webgune billing plans # Preisübersicht
webgune billing subscription # Ihre Abonnements (Konto + dedizierte pro Projekt) und der SEPA-Mandatsstatus
webgune billing invoices # Ihre Rechnungen
webgune billing cancel # Kündigung des Konto-Abonnements (Wirkung am Ende der Periode)
webgune billing cancel --project <id> # Kündigung eines einem Projekt gewidmeten Abonnements
Gemäß den Allgemeinen Geschäftsbedingungen tritt die Kündigung eines Tarifs am Ende des bereits bezahlten Zeitraums in Kraft. Ihre Dienste bleiben bis dahin aktiv. Die Kündigung wird abgelehnt, wenn eine Rechnung zur Zahlung aussteht.
Domains
webgune domains list
JSON-Ausgabe
Alle Listing-Befehle akzeptieren --json für eine rohe, skriptfähige Ausgabe:
webgune services list --json | jq '.[].name'
Siehe auch
- MCP-Server: steuern Sie webgune von Claude oder jedem MCP-Client aus.
- API-Referenz: die zugrunde liegende HTTP-API.