CLI Webgune
CLI Webgune
Le CLI officiel webgune vous permet de gérer vos projets, services, déploiements et factures directement depuis le terminal.
Installation
bun add -g webgune
# ou
npm install -g webgune
Node.js 18 ou supérieur est requis.
Authentification
webgune login
Sans option, webgune login ouvre votre navigateur, comme l'extension VS Code, pour autoriser le CLI sur votre compte connecté. Une clé API (préfixe wgk_) est créée automatiquement avec les scopes nécessaires (projects, services, domains:read, billing) et renvoyée au CLI via un serveur local (127.0.0.1). Rien à copier-coller.
Pour un usage scripté (CI, conteneur sans navigateur), passez une clé existante directement. Créez-la dans le dashboard, Paramètres → Clés API :
webgune login --key wgk_xxxxxxxx
La clé est enregistrée dans ~/.webgune/config.json. Vous pouvez aussi utiliser des variables d'environnement, utiles en CI :
export WEBGUNE_API_KEY=wgk_xxxxxxxx
export WEBGUNE_API_URL=https://api.webgune.cloud # optionnel
Commandes
Projets
webgune projects list
webgune projects create mon-projet
webgune projects delete <id>
Services
webgune services list # tous vos services
webgune services list --project <id> # filtrés par projet
webgune services info <id> # détails complets
webgune services logs <id> --tail 500 # logs d'exécution
webgune services redeploy <id> # rebuild + redéploiement
webgune services restart <id>
webgune services stop <id>
webgune services start <id>
Déploiements
webgune services deployments <id> # historique
webgune services rollback <serviceId> <deployId> # retour arrière
Facturation
webgune billing plans # grille tarifaire
webgune billing subscription # vos abonnements (compte + dédiés par projet) et l'état du mandat SEPA
webgune billing invoices # vos factures
webgune billing cancel # résiliation de l'abonnement du compte (effet en fin de période)
webgune billing cancel --project <id> # résiliation d'un abonnement dédié à un projet
Conformément aux Conditions Générales de Services, la résiliation d'un forfait prend effet à la fin de la période déjà payée. Vos services restent actifs jusque-là. La résiliation est refusée si une facture est en attente de paiement.
Domaines
webgune domains list
Sortie JSON
Toutes les commandes de listing acceptent --json pour une sortie brute exploitable en script :
webgune services list --json | jq '.[].name'
Voir aussi
- Serveur MCP : pilotez webgune depuis Claude ou tout client MCP.
- Référence API : l'API HTTP sous-jacente.