Skip to main content
La Whop CLI (whop) met l’API actuelle dans votre terminal : déployez des apps, créez des produits, définissez des prix, envoyez des versements, diffusez des publicités et récupérez des statistiques. Chaque commande fonctionne aussi de manière non interactive pour les scripts et les agents IA.
La CLI n’a pas de mode sandbox ni de mode test. Chaque commande s’exécute en production, et beaucoup peuvent créer des ressources réelles ou déplacer de l’argent réel. Les commandes qui modifient l’état demandent une confirmation, et whop send --dry-run prévisualise un paiement sans l’envoyer.

Installation

Les scripts d’installation placent whop dans ~/.local/bin (%USERPROFILE%\.local\bin sous Windows) et ne modifient pas votre profil de shell. Si whop est introuvable ensuite, ajoutez ce répertoire à votre PATH, par exemple export PATH="$HOME/.local/bin:$PATH". Définissez WHOP_INSTALL_DIR pour installer ailleurs. Le package npm nécessite Node.js 22 ou une version ultérieure.
Vérifiez l’installation. La commande affiche le numéro de version :
whop --help affiche également la version de l’API utilisée par la CLI.

Connexion

whop login --method oauth ouvre un navigateur. whop login --method api-key --apiKey whop_xxx est non interactif. Les profils vous permettent de conserver plusieurs identités : whop auth list, whop auth switch et whop auth status permettent de les gérer. Choisissez ensuite l’entreprise sur laquelle agit la CLI :

Contenu

74 groupes de commandes, organisés comme les regroupe whop --help : Consultez Commandes pour la liste de toutes les commandes, ou exécutez whop <group> --help.

Commandes courantes

La plupart des groupes suivent la même structure : whop <resource> list|get|create|update. Chaque commande accepte --format json pour une sortie structurée. Les commandes liées à un compte utilisent par défaut l’entreprise sélectionnée, et --account_id permet d’en choisir une autre.

Déployer une app

Compile, vérifie les types, téléverse et promeut le projet lié en production. Passez --preview pour téléverser sans promouvoir, puis publiez plus tard avec whop apps builds promote <build_id>. La promotion d’un build plus ancien est aussi la façon d’effectuer un retour en arrière. Après un déploiement, consultez les logs serveur de votre app :

Utilisation non interactive

Pour la CI, les scripts ou les agents sans interface, définissez WHOP_API_KEY au lieu de vous connecter. Créez une clé sous Developer dans votre tableau de bord, et consultez Authentification et clés API avant d’en confier une à un agent.
Les installations autonomes sous macOS et Linux se mettent à jour automatiquement en arrière-plan. Définissez WHOP_CLI_AUTO_UPDATE=0 pour recevoir uniquement une notification. Sinon, un terminal interactif vous indique lorsqu’une nouvelle version est disponible, et whop --update l’installe. Les installations Homebrew se mettent à jour avec brew upgrade whop.

Étapes suivantes

Commandes

Chaque groupe de commandes, avec les descriptions issues de la CLI elle-même.

Mode agent

Synchronisation des skills et flags de sortie lisible par machine.

Développer avec la CLI et Claude

Générez et publiez une app Whop avec un agent dans la boucle.

Authentification et clés API

Définissez la portée des identifiants avec lesquels vous connectez la CLI.