Whop CLI

whop is your entire business on the command line. Ship software, sell products, move money, buy ads, hire people, and read the numbers.

whop accounts create --title "Acme"                       # create a business
whop apps deploy                                          # ship a web app to *.whop.app
whop products create --title "Pro membership"             # something to sell
whop checkout-configurations create --plan_id plan_xxx    # a link that accepts money
whop media generate --type image --prompt "launch art"    # make an ad creative
whop ads create …                                         # put it on Meta/Tiktok
whop payouts create …                                     # send earnings to your bank
whop stats list                                           # how it's all going

With the CLI you can:

• Ship software: build and deploy hosted web apps to *.whop.app, with previews, rollbacks, secrets, and production logs
• Sell anything: products, one-time / recurring / trial pricing, checkout links
• Move money: payouts, transfers, deposits, currency swaps, spending cards
• Advertise: generate AI images and video, run Meta or Tiktok campaigns
• Hire: post bounties with escrowed rewards, review submissions, pay the winners
• Measure: financial, audience, and traffic stats, plus tracked people and events
• Automate all of it: structured output, a machine-readable manifest, an MCP server, and agent skills built in

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/cli

Prebuilt binaries cover macOS and Linux (releases); on other platforms, use npm. The standalone installer uses your standard user executable directory ($XDG_BIN_HOME or ~/.local/bin).

Getting started

whop

That's it! Run whop auth accounts anytime to switch businesses.

Usage

whop --help                  # all commands
whop products list           # what you're selling
whop plans create --help     # options for any command
whop stats list              # your numbers
whop accounts get --account_id jordan   # retrieve a business by route

Every command takes --format json for structured output, or --format jsonl to stream events.

Account-scoped commands use the selected business by default. Pass another business's biz_ ID or public route with --account_id.

In a terminal, commands prompt for missing inputs. Agents and scripts (non-TTY) get a structured validation error instead, so nothing hangs.

Ship apps

Hosted web apps (*.whop.app) follow a git-shaped lifecycle. Two on-ramps, one loop:

whop apps init                    # start a NEW app: registers, scaffolds, git-inits
whop apps pull --app app_xxx      # or pull an EXISTING app's deployed source

# The loop
whop apps dev                     # local dev server, credentials auto-injected
whop apps deploy                  # build, typecheck, upload, promote to production

deploy --preview uploads without promoting. whop apps builds promote <build_id> ships a build later, and promoting an older build rolls back. pull merges the deployed source with your local files via git, so conflicts show up as normal git conflict markers.

The rest is plain REST: whop apps list|create|get|update, whop apps builds list|get|promote, whop apps secrets list|set|unset. The whop() Vite build plugin ships as @whop/cli/vite.

After a deploy, read your app's server logs (kept for 7 days):

whop apps logs app_xxxxxxxx --level error
whop apps logs app_xxxxxxxx --query "checkout"

Sell and get paid

whop products create --title "Pro membership"
whop plans create --help                            # one-time, recurring, trials, stock
whop checkout-configurations create --help          # shareable, prefilled checkout link
whop stats list                                     # financial, audience, and traffic reporting

Money moves through the same surface: payouts, transfers, deposits, swaps, and cards. Payouts and card issuing require identity verification (whop verifications). Steps that need a browser, like KYC, show up as a link to open.

Serve the customers you have

whop members list --access_level customer         # one row per buyer
whop memberships cancel mem_xxx --reason "moved"  # also pause, resume, extend
whop shipments create --payment_id pay_xxx --tracking_number 1Z999
whop disputes list                                # chargebacks, with evidence and outcomes
whop resolution-center-cases reply reso_xxx --help # answer a case before it escalates

Export and notify

whop exports create --resource receipts     # then poll until download_url is set
whop exports get exprt_xxx
whop notifications create --experience_id exp_xxx --title "New drop" --content "Live now"

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 ready

The whop-ads skill (whop skills add) carries the full playbook.

Hire a workforce

whop bounties create --help              # paid tasks with escrowed rewards
whop bounty-submissions list --help      # review submitted work, approve to pay

Upload files

whop files create --filename "banner.png"
whop files get file_xxxxxxxxxxxxx

create returns a presigned upload_url and upload_headers. Upload the bytes there, then get returns the file URL once it's ready.

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         # automatically register with supported coding agents
whop mcp doctor      # diagnose an MCP registration
whop skills add      # generate agent skills (per-resource playbooks)

For OAuth, run whop login --method oauth --format jsonl in the background with stdout redirected to a file (pipes like | head can buffer past the URL). The first line carries an authorizationUrl; open it in the user's browser, unedited. Once the process exits, you're logged in.

For unattended automation, set WHOP_API_KEY (create one under Developer → API keys). For API commands, it takes precedence over any saved CLI profile for that invocation.

Authentication

whop login --method oauth                           # interactive browser login
whop login --method oauth --format jsonl            # stream the authorization URL for an agent
whop login --method api-key --api-key whop_xxx      # explicit API-key login
WHOP_API_KEY=whop_xxx whop login --method api-key   # API key from the environment

List your businesses with whop auth account --list and switch with whop auth account <biz_id>.

The OAuth flow redirects to localhost:13337, so the browser must run on the same host as the CLI (or forward that port).

Invocation logs

Every run appends one JSON line (arguments with secrets redacted, exit code, duration) to ~/.config/whop/logs/audit-YYYY-MM-DD.jsonl. Logs older than 7 days are deleted.

WHOP_CLI_AUDIT_RETENTION_DAYS=30 whop …   # keep logs longer
WHOP_CLI_AUDIT_LOG=0 whop …               # disable logging

Updating

The CLI keeps itself up to date. To update manually, run whop upgrade.

Documentation

• Whop CLI docs
• Whop developer docs
• Bugs and feature requests: issues