@whop/cli 0.13.0 → 0.14.0

package/README.md

@@ -1,6 +1,29 @@
 # Whop CLI
 
-`whop` — build and manage your Whop business from the terminal. Deploy apps, manage products and pricing, run ads, move money, and automate workflows from one agent-friendly CLI.
+`whop` is your entire business on the command line. Ship software, sell products, move money, buy ads, hire people, and read the numbers.
+
+```bash
+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
 
@@ -15,9 +38,7 @@ brew install whopio/tap/whop
 npm install -g @whop/cli
 ```
 
-Prebuilt binaries cover macOS and Linux ([releases](https://github.com/whopio/whop-public-cli/releases)); on other platforms, use npm.
-
-The standalone installer uses your standard user executable directory (`$XDG_BIN_HOME` or `~/.local/bin`) and updates your shell profile when needed.
+Prebuilt binaries cover macOS and Linux ([releases](https://github.com/whopio/whop-public-cli/releases)); on other platforms, use npm. The standalone installer uses your standard user executable directory (`$XDG_BIN_HOME` or `~/.local/bin`).
 
 ## Getting started
 
@@ -25,7 +46,7 @@ The standalone installer uses your standard user executable directory (`$XDG_BIN
 whop
 ```
 
-That's it — it signs you in, lets you choose or create the business the CLI should use, and points you to the available workflows. Run `whop quickstart` later to change the selected business.
+That's it! Run `whop auth accounts` anytime to switch businesses.
 
 ## Usage
 
@@ -34,75 +55,73 @@ 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 biz_xxx  # target another business
 ```
 
-Every command takes `--format json` for structured output.
+Every command takes `--format json` for structured output, or `--format jsonl` to stream events.
 
-In a terminal, commands that are missing required inputs ask for them interactively instead of failing — run `whop swaps quote` with no flags and it prompts for the amount and tokens. Agents and scripts (non-TTY) get a structured validation error instead.
+Account-scoped commands use the selected business by default. Pass another business with `--account_id`.
 
-## Authentication
+In a terminal, commands prompt for missing inputs. Agents and scripts (non-TTY) get a structured validation error instead, so nothing hangs.
 
-```bash
-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
-```
+## Ship apps
 
-Agent OAuth recipe:
-
-1. Run `whop login --method oauth --format jsonl` in the background with stdout redirected to a file — pipes like `| head` can buffer past the URL.
-2. The first line is an `authorization_required` event, emitted once the local callback listener is ready. Open its `authorizationUrl` in the user's browser (e.g. `open <url>` on macOS, `xdg-open <url>` on Linux). The URL is several KB long (it carries the full scope list): pass it programmatically and never retype, truncate, or summarize it — a mangled scope list fails with `invalid_scope`.
-3. Wait for the process to exit — the final `done` event means the profile is saved.
-4. If the user manages more than one business, the login succeeds without picking one; set it with `whop auth account <biz_id>` (`whop auth account --list` to enumerate) — no second browser round-trip needed.
-
-The flow redirects to `localhost:13337`, so the browser must run on the same host as the CLI (or forward that port to the CLI host). Fully remote browser authorization will require a future device login flow.
-
-## Build and deploy apps
-
-Fully-hosted web apps (`*.whop.app`) follow a git-shaped lifecycle — two on-ramps, one loop:
+Hosted web apps (`*.whop.app`) follow a git-shaped lifecycle. Two on-ramps, one loop:
 
 ```bash
-# Start a NEW app: registers it, scaffolds the latest TanStack Start
-# template (or --template app_xxx to clone another app's published source),
-# wires it for Whop hosting, installs, and git-inits
-whop apps init
-
-# …or get an EXISTING app's deployed source onto this machine: downloads the
-# production build's source archive (--build abld_xxx for any specific build)
-# and three-way merges it with whatever is here via git
-whop apps pull --app app_xxxxxxxx
+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
+whop apps deploy                  # build, typecheck, upload, promote to production
 ```
 
-`deploy` ships the linked project; `--preview` uploads without promoting, and `whop apps builds promote <build_id>` ships it later — promoting an older build is also how you roll back. `pull` and `deploy` share a per-app snapshot ref (`refs/whop/remote/<app_id>`), so pulls always merge against the last state this machine saw: local edits are autostashed around the merge and conflicts surface as normal git conflict markers.
+`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.
 
-Everything else is plain REST: `whop apps list|create|get|update`, `whop apps builds list|get|promote`, and `whop apps secrets list|set|unset`.
+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 — every `console.log`, uncaught exception, and failed request, kept for 7 days:
+After a deploy, read your app's server logs (kept for 7 days):
 
 ```bash
 whop apps logs app_xxxxxxxx --level error
 whop apps logs app_xxxxxxxx --query "checkout"
 ```
 
-## Create file uploads
 
-Create a file record to receive the presigned upload URL and headers, then retrieve its current status:
+
+## Sell and get paid
 
 ```bash
-whop files create --filename "banner.png"
-whop files get file_xxxxxxxxxxxxx
+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
 ```
 
-Upload the file's bytes to the returned `upload_url` using its `upload_headers`. The response from `whop files get` includes the file URL once the upload is ready.
+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
+
+```bash
+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
+
+```bash
+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:
+Generate a creative, then create the campaign, ad group, and ad in one command. Structured flags take JSON strings:
 
 ```bash
 whop media generate --type image --prompt "A running club at sunrise" --wait
@@ -114,35 +133,71 @@ whop ads create \
 whop ad-campaigns update <adcamp_id> --status active   # launch when ready
 ```
 
-The installed `whop-ads` skill (`whop skills add`) carries the full playbook — billing setup, field rules, and monitoring.
+The `whop-ads` skill (`whop skills add`) carries the full playbook.
+
+## Hire a workforce
+
+```bash
+whop bounties create --help              # paid tasks with escrowed rewards
+whop bounty-submissions list --help      # review submitted work, approve to pay
+```
+
+
+
+## Upload files
+
+```bash
+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:
+The CLI is self-describing. Agents can discover and drive every command:
 
 ```bash
 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 skills
+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` and show the emitted URL to the user. For unattended automation, set `WHOP_API_KEY` instead (create one under **Developer → API keys**).
+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**).
+
+## Authentication
+
+```bash
+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 — timestamp, arguments (secrets redacted), exit code, duration — to `~/.config/whop/logs/audit-YYYY-MM-DD.jsonl` so you can retrace what the CLI did when debugging. Logs older than 7 days are deleted automatically.
+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.
 
 ```bash
 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](https://docs.whop.com/developer/cli)
 - [Whop developer docs](https://docs.whop.com)
-- [whop.com/developers](https://whop.com/developers/)
 - Bugs and feature requests: [issues](https://github.com/whopio/whop-public-cli/issues)

package/dist/{chunk-KFCNNWPI.js → chunk-4MBHKXEL.js}

@@ -1,10 +1,40 @@
 #!/usr/bin/env node
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
+var __create = Object.create;
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 
 // ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/core.js
 var NEVER = Object.freeze({
@@ -13777,7 +13807,10 @@ function fromJSONSchema(schema, params) {
 config(en_default());
 
 export {
+  __require,
+  __commonJS,
   __export,
+  __toESM,
   NEVER,
   iso_exports,
   safeParse2 as safeParse,
@@ -13804,4 +13837,4 @@ export {
   coerce_exports,
   external_exports
 };
-//# sourceMappingURL=chunk-KFCNNWPI.js.map
+//# sourceMappingURL=chunk-4MBHKXEL.js.map