Package Exports
- @whop/cli
- @whop/cli/vite
Readme
Whop CLI
whop — sell on Whop from your terminal. Create products, set pricing, and get a shareable checkout link without leaving your shell.
Installation
# macOS / Linux
curl -fsSL https://whop.com/install.sh | sh
# Homebrew
brew install whopio/tap/whop
# npm (requires Node.js >= 22)
npm install -g @whop/cliPrebuilt binaries cover macOS and Linux (releases); on other platforms, use npm.
Getting started
whopThat's it — it signs you in and walks you to a shareable checkout link.
Usage
whop --help # all commands
whop products list # what you're selling
whop plans create --help # options for any command
whop stats list # your numbersEvery command takes --format json for structured output.
Deploy an app
whop apps deployThe one-stop deploy for fully-hosted web apps (*.whop.app): it verifies the current directory is a Whop-ready Vite app — offering to scaffold a new one or link an existing Whop app if not — then builds, typechecks, uploads, and promotes the build to production. Use --skip_promote to upload a preview build, and whop apps builds promote <build_id> to ship it later. Everything else is plain REST: whop apps list|create|get|update and whop apps builds list|get|create|promote.
After a deploy, read your app's server logs — every console.log, uncaught exception, and failed request, kept for 7 days:
whop apps logs # recent logs for the linked app
whop apps logs --level error --since 1h
whop apps logs --query "checkout"Run ads
Generate a creative, then create the campaign, ad group, and ad in one command — structured flags take JSON strings:
whop media generate --type image --prompt "A running club at sunrise" --wait
whop ads create \
--title "Launch ad" --headlines "Find your stride" --call_to_action sign_up \
--url "https://whop.com/your-store" \
--creatives '[{"id":"file_x"}]' --social_accounts '[{"id":"sacc_x"}]' \
--ad_group '{"title":"US broad","conversion_location":"website","ad_campaign":{"title":"Growth","platform":"meta","objective":"sales","status":"draft","budget_amount":25,"budget_optimization":"ad_campaign"}}'
whop ad-campaigns update <adcamp_id> --status active # launch when readyThe installed whop-ads skill (whop skills add) carries the full playbook — billing setup, field rules, and monitoring.
For AI agents
The CLI is self-describing — agents can discover and drive every command:
whop --llms # machine-readable manifest of all commands
whop mcp add # register as an MCP server (e.g. Claude Desktop)
whop skills add # generate agent skillsSet WHOP_API_KEY for non-interactive use (create one under Developer → API keys).
Updating
The CLI keeps itself up to date. To update manually, run whop upgrade.
Documentation
- Whop developer docs
- whop.com/developers
- Bugs and feature requests: issues