> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Whop CLI

> Installez la Whop CLI, connectez-vous et gérez toute votre entreprise depuis le terminal : 74 groupes de commandes couvrant le commerce, l'argent, les publicités et les apps.

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.

> [!WARNING]
>
> 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

```bash macOS / Linux theme={null}
curl -fsSL https://whop.com/install.sh | sh
```

```powershell Windows theme={null}
irm https://github.com/whopio/whop-public-cli/releases/latest/download/install.ps1 | iex
```

```bash Homebrew theme={null}
brew install whopio/tap/whop
```

```bash npm theme={null}
npm install -g @whop/cli
```

> [!NOTE]
>
> 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 :

```bash theme={null}
whop --version
```

`whop --help` affiche également la version de l'API utilisée par la CLI.

## Connexion

```bash theme={null}
whop login
```

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

```bash theme={null}
whop quickstart
```

## Contenu

74 groupes de commandes, organisés comme les regroupe `whop --help` :

| Catégorie | Groupes |
| - | - |
| Prise en main | `quickstart` · `apps` |
| Commerce | `products` · `variants` · `promo-codes` · `checkout-configurations` · `waitlist-entries` · `memberships` · `shipments` · `reviews` · `review-reports` · `product-affiliates` |
| Ressources principales | `accounts` · `users` · `members` · `team-members` · `search` · `external-accounts` · `social-accounts` |
| Paiements | `payments` · `invoices` · `confirmation-tokens` · `payment-quotes` · `setup-intents` · `refunds` · `resolution-center-cases` · `dispute-alerts` · `disputes` · `payment-rules` · `financing-applications` |
| Argent | `deposits` · `transfers` · `payouts` · `ledgers` · `cards` · `cashback-rules` · `swaps` · `trades` · `verifications` · `send` |
| Sites web | `domains` · `app-installations` · `experiments` |
| Publicités | `ad-campaigns` · `ad-groups` · `ads` · `audiences` · `ad-pixels` |
| Analytique | `stats` · `people` · `events` · `exports` · `economic-intelligence` |
| Communication | `livestreams` · `notifications` · `email-addresses` |
| Partenaires | `partners` · `partner-referral-requests` |
| Main-d'œuvre | `bounties` · `bounty-submissions` |
| Médias | `files` · `media` |
| Développeur | `api-keys` · `webhooks` · `permissions` · `api-logs` · `report-feedback` · `ask-question` |
| Authentification | `auth` · `login` · `logout` |
| Intégrations | `completions` · `mcp` · `skills` |

Consultez [Commandes](https://docs.whop.com/fr/cli/commands.md) pour la liste de toutes les commandes, ou exécutez `whop <group> --help`.

## Commandes courantes

```bash theme={null}
whop --help                  # all commands
whop products list           # what you're selling
whop variants create --help  # options for any command
whop checkout-configurations create --variant_id plan_xxx   # shareable checkout link
whop stats time-series list  # the metric catalog
whop stats time-series get net_revenue --from 2026-01-01 --to 2026-01-31
whop accounts get jordan     # retrieve a business by route
```

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

```bash theme={null}
whop apps deploy
```

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 :

```bash theme={null}
whop apps logs app_xxx               # recent logs for your app
whop apps logs app_xxx --level error --query "checkout"
```

## 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](https://whop.com/dashboard), et consultez [Authentification et clés API](https://docs.whop.com/fr/developer/guides/auth-scoping.md) avant d'en confier une à un agent.

```bash theme={null}
WHOP_API_KEY=whop_xxx whop products list --format json
```

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

> [card] [Commandes](https://docs.whop.com/fr/cli/commands.md)
>
> Chaque groupe de commandes, avec les descriptions issues de la CLI elle-même.

> [card] [Mode agent](https://docs.whop.com/fr/cli/agent-mode.md)
>
> Synchronisation des skills et flags de sortie lisible par machine.

> [card] [Développer avec la CLI et Claude](https://docs.whop.com/fr/developer/guides/cli-with-claude.md)
>
> Générez et publiez une app Whop avec un agent dans la boucle.

> [card] [Authentification et clés API](https://docs.whop.com/fr/developer/guides/auth-scoping.md)
>
> Définissez la portée des identifiants avec lesquels vous connectez la CLI.


## Related topics

- [Commandes de la Whop CLI](https://docs.whop.com/fr/cli/commands.md)
- [Mode agent de la Whop CLI](https://docs.whop.com/fr/cli/agent-mode.md)
- [Créer un site web avec la CLI](https://docs.whop.com/fr/developer/websites/quickstart.md)
