@whop/cli 0.6.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whop/cli",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "The Whop CLI — build and manage Whop apps from your terminal. Human and agent friendly.",
   "keywords": [
     "agent",
@@ -45,7 +45,7 @@
   "devDependencies": {
     "@types/node": "25.3.5",
     "fflate": "0.8.2",
-    "incur": "github:whopio/incur#4b9ca91dc02472db944fb103984ffc4a13251b6f",
+    "incur": "github:whopio/incur#fbe3f4dbf48f1bc780cb1bca476f7dade1fe12d3",
     "tsup": "8.5.0",
     "tsx": "4.19.4",
     "typescript": "5.9.3",

package/skills/whop-accounts/SKILL.md

@@ -5,9 +5,9 @@ requires_bin: whop
 command: whop accounts
 ---
 
-An Account represents a person or business in Whop. Each account has its own profile, wallet, and settings, so you can create one for every customer, creator, merchant, or seller your integration supports.
+An Account represents a person or business on Whop that can have its own profile, wallet, and account-scoped settings. Use accounts for customers, creators, merchants, sellers, or connected businesses your integration supports.
 
-Create an account when someone needs to hold funds, receive payments, send money, or use account-scoped API features. Save the returned `id` and `wallet` details, and use `metadata` to store your own stable identifier, like a user ID from your system.
+Use the Accounts API to create accounts, list accounts visible to your credentials, retrieve or update an account, and retrieve the account associated with the current API key.
 
 ## Commands
 
@@ -18,5 +18,8 @@ Create an account when someone needs to hold funds, receive payments, send money
 | `whop accounts me` | Retrieve Requesting Account |
 | `whop accounts get` | Retrieve Account |
 | `whop accounts update` | Update Account |
+| `whop accounts preferences` | Retrieve Account Preferences |
+| `whop accounts update-preferences` | Update Account Preferences |
+| `whop accounts recommend_actions` | List Recommended Actions |
 
 Run `whop accounts <command> --help` for options, or `whop accounts <command> --schema` for full argument details.

package/skills/whop-ads/SKILL.md

@@ -22,3 +22,79 @@ Use the Ads API to list ads for an account, create ads inside ad groups, retriev
 | `whop ads unpause` | Unpause an Ad |
 
 Run `whop ads <command> --help` for options, or `whop ads <command> --schema` for full argument details.
+
+## Launch playbook — from nothing to a live ad
+
+Three commands take you from nothing to a launchable ad: generate a creative, create the campaign + ad group + ad in one request, then flip the campaign to active. Structured flags (`--ad_group`, `--creatives`, `--ads_payment_methods`) take JSON strings.
+
+### One-time setup
+
+1. **Auth** — `whop login` (OAuth). First-time billing setup requires a user login; an API key can only reorder already-configured payment methods. If a command fails with a scope error saying your login predates the scope, run `whop login` again.
+2. **Facebook page** — `whop social-accounts list` must show a `"platform": "facebook"` entry. Three ways to get one:
+   - **Already connected** — use its `sacc_` id as-is.
+   - **Link a Meta Business account** — `whop social-accounts connect --platform meta_business --scopes '["advertise"]' --redirect_url <url>`, then send the user to the returned `authorize_url`.
+   - **No page at all** — have Whop create one for the account: `whop social-accounts create --platform facebook`.
+3. **Ads payment method** — check with `whop accounts preferences <account_id>` (your `biz_` ID, from `whop accounts me`). If `ads_payment_methods` is null, configure balance billing:
+
+   ```sh
+   whop accounts update-preferences <account_id> --ads_payment_methods '{"primary": {"type": "platform_balance"}}'
+   ```
+
+   Only launching needs this — drafts work without. Fund the balance with `whop deposits create --amount 50` (returns a hosted deposit page URL).
+
+### 1. Generate a creative
+
+```sh
+whop media generate --type image --prompt "A running club jogging across a bridge at sunrise, warm light" --wait
+```
+
+`--wait` blocks until the asset is terminal and returns `file.id` — use that as the creative. Billed from the balance (`amount_charged`); a failed generation auto-refunds, so adjust the prompt and retry. Video: `--type video` plus optional `--duration_seconds` (5/10/15), `--resolution` (480p–4k), and up to 4 `--reference_media` file IDs (first one seeds the opening frame).
+
+### 2. Create the whole tree as a draft — one request
+
+```sh
+whop ads create \
+  --title "Run club launch ad" \
+  --primary_texts "Join 10,000 runners chasing their next PR together." \
+  --headlines "Find your stride" \
+  --call_to_action sign_up \
+  --url "https://whop.com/your-store-page" \
+  --creatives '[{"id": "file_XXXXXXXX"}]' \
+  --social_accounts '[{"id": "sacc_XXXXXXXX"}]' \
+  --ad_group '{
+    "title": "US broad",
+    "conversion_location": "website",
+    "regions": {"include": {"countries": ["US"]}},
+    "ad_campaign": {"title": "Run club growth", "platform": "meta", "objective": "sales", "status": "draft", "budget_amount": 25, "budget_optimization": "ad_campaign"}
+  }'
+```
+
+Field rules:
+
+| Field | Rule |
+|-------|------|
+| `creatives` | One entry with no `format` is required (the base asset). `square`/`vertical`/`horizontal` are optional crops on top. |
+| `url` | Required for website ads. A whop.com store page works as-is; an external page needs the Whop pixel installed. |
+| Budget | Default to CBO: `budget_amount` on the campaign with `budget_optimization: "ad_campaign"` (the network shifts spend to the best ad group). Per-ad-group `budget_amount` (ABO) is the manual alternative. One level owns it — never both. |
+| Targeting | Omit `demographics`/`placements`/`devices` for automatic optimization. `regions` uses ISO 3166 (`"US"`, `"US-CA"`). |
+| `lead_form` | Only with an instant-form `conversion_location`. |
+
+Reuse existing containers by passing `--ad_group_id adgrp_x` instead of `--ad_group`, or `"ad_campaign_id": "adcamp_x"` inside `--ad_group` instead of the inline `ad_campaign`.
+
+### 3. Launch
+
+`"status": "draft"` above kept money out of it. Review, then launch — this is when spend starts and the payment method is enforced:
+
+```sh
+whop ad-campaigns update adcamp_XXXXXXXX --status active
+```
+
+(Ready to spend immediately? Omit `"status": "draft"` and the one-shot create launches directly.)
+
+### 4. Monitor
+
+```sh
+whop ads get ad_XXXXXXXX
+```
+
+`delivery_status` is the live state (a brief `in_review` for moderation is normal); `issues[]` carries a human-readable `message` for anything the network rejected asynchronously. Control delivery with `pause`/`unpause` on ads, ad groups, or campaigns. Edit copy or creatives with `whop ads update` — sending `creatives` replaces the whole set, so include the base entry.

package/skills/whop-apps/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: whop-apps
+description: "Apps you build on Whop: metadata, hosted builds, runtime logs. Run `whop apps --help` for usage details."
+requires_bin: whop
+command: whop apps
+---
+
+An App is software you build on Whop. It can be a hosted web app served at `<route>.whop.app` or an API integration installed as an experience, and it belongs to the account that owns its credentials, settings, builds, and runtime logs.
+
+Use the Apps API to manage app configuration and, for hosted apps, read server runtime logs for console output, uncaught exceptions, and failed requests. Logs are retained for 7 days and can be filtered by build, level, time window, and message text.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop apps logs` | List App Logs |
+
+Run `whop apps <command> --help` for options, or `whop apps <command> --schema` for full argument details.

package/skills/whop-events/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: whop-events
+description: Conversion and engagement events tracked for attribution. Run `whop events --help` for usage details.
+requires_bin: whop
+command: whop events
+---
+
+An Event records conversion or engagement activity for an account, such as page views, purchases, or leads. Each event ties the action to the [person](https://docs.whop.com/api-reference/beta/people/person) who took it, so activity can be attributed to the ads and links that drove it.
+
+Use the Events API to send new tracking events and list the events recorded for a person.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop events list` | List Events |
+| `whop events create` | Create Event |
+
+Run `whop events <command> --help` for options, or `whop events <command> --schema` for full argument details.

package/skills/whop-media/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: whop-media
+description: AI-generated assets, billed from a balance, attachable wherever files are accepted. Run `whop media --help` for usage details.
+requires_bin: whop
+command: whop media
+---
+
+A Media Asset is an AI-generated image or video created from a prompt and billed from an account balance. When generation finishes, the asset includes a file that can be attached anywhere Whop accepts files.
+
+Use the Media API to start a generation job and retrieve the asset while it processes or after it is ready.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop media generate` | Generate Media Asset |
+| `whop media get` | Retrieve Media Asset |
+
+Run `whop media <command> --help` for options, or `whop media <command> --schema` for full argument details.
+
+## Steps that finish in the browser
+
+Some commands respond with a URL the user must open in a browser to finish the flow (`authorize_url`, `session_url`, `deposit_url`) — the CLI cannot complete that step itself. When a response contains one of these fields, or the CLI prints "Action required: open this link in the user's browser", open that link in the user's browser for them, tell them what to complete there, then re-run the matching `get`/`list` command to confirm the step finished.

package/skills/whop-partners/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: whop-partners
+description: The users and businesses you referred to Whop, and what you earn from them. Run `whop partners --help` for usage details.
+requires_bin: whop
+command: whop partners
+---
+
+The Referrals API covers your Whop partner activity: the users you referred onto Whop, the businesses you referred and the earnings generated from their processing volume, and the partner leaderboard.
+
+Use it to enroll as a Whop partner, list the users you referred, list your referred businesses and review their earnings, and see the partner leaderboard.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop partners create` | Enroll as a Whop partner |
+| `whop partners list` | List partner business referrals |
+| `whop partners get` | Retrieve a partner business referral |
+| `whop partners earnings` | List a partner business referral's earnings |
+| `whop partners leaderboard` | Retrieve the partner leaderboard |
+| `whop partners referred_users` | List the users the caller referred |
+
+Run `whop partners <command> --help` for options, or `whop partners <command> --schema` for full argument details.

package/skills/whop-payouts/SKILL.md

@@ -5,15 +5,16 @@ requires_bin: whop
 command: whop payouts
 ---
 
-Payouts represent money sent from an account balance to an external destination, such as a bank account or other supported payout method.
+Payouts represent money sent from an account or user balance to an external destination, such as a bank account, wallet, or other saved payout method.
 
-Use the Payouts API to list payout history, monitor payout statuses, and show expected arrival details for funds leaving an account.
+Use the Payouts API to create payouts from stablecoin accounts, list payout history for accounts or users, monitor payout statuses, and show expected arrival details for funds leaving Whop.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `whop payouts list` | List Payouts |
+| `whop payouts create` | Create Payout |
 | `whop payouts methods` | List Payout Methods |
 
 Run `whop payouts <command> --help` for options, or `whop payouts <command> --schema` for full argument details.

package/skills/whop-people/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: whop-people
+description: Visitors and customers of an account, aggregated from pixel events. Run `whop people --help` for usage details.
+requires_bin: whop
+command: whop people
+---
+
+A Person represents a visitor or customer of an account, assembled from [pixel events](https://docs.whop.com/api-reference/beta/events/event) and purchase activity — ad clicks, storefront visits, and checkouts.
+
+Use the People API to list the people of an account and retrieve a single person.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop people list` | List People |
+| `whop people get` | Retrieve Person |
+
+Run `whop people <command> --help` for options, or `whop people <command> --schema` for full argument details.

package/skills/whop-social-accounts/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: whop-social-accounts
+description: Connected Facebook and Instagram accounts that run ads. Run `whop social-accounts --help` for usage details.
+requires_bin: whop
+command: whop social-accounts
+---
+
+A Social Account represents an external profile connected to a Whop account or user, such as a Facebook page or Instagram account. Connecting a social account lets Whop run [ads](https://docs.whop.com/api-reference/beta/ads/ad) under that profile's identity and promote its existing posts.
+
+Use the Social Accounts API to list connected accounts, create a Whop-managed Facebook page, start an OAuth connection, disconnect a social account, and list a connected profile's posts.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop social-accounts list` | List Social Accounts |
+| `whop social-accounts create` | Create a Social Account |
+| `whop social-accounts connect` | Connect a Social Account |
+| `whop social-accounts delete` | Delete a Social Account |
+| `whop social-accounts posts` | List Social Account Posts |
+
+Run `whop social-accounts <command> --help` for options, or `whop social-accounts <command> --schema` for full argument details.
+
+## Steps that finish in the browser
+
+Some commands respond with a URL the user must open in a browser to finish the flow (`authorize_url`, `session_url`, `deposit_url`) — the CLI cannot complete that step itself. When a response contains one of these fields, or the CLI prints "Action required: open this link in the user's browser", open that link in the user's browser for them, tell them what to complete there, then re-run the matching `get`/`list` command to confirm the step finished.

package/skills/whop-stats/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: whop-stats
+description: Aggregated account time series for reporting. Run `whop stats --help` for usage details.
+requires_bin: whop
+command: whop stats
+---
+
+Stats represent aggregated activity for an account over time. They help you understand revenue, transactions, disputes, members, referrals, and advertising performance across reporting periods like days, weeks, or months.
+
+Use the Stats API to list available metrics and their filterable properties, then retrieve time-series values for a date range.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop stats list` | List Metrics |
+| `whop stats get` | Retrieve Metric |
+
+Run `whop stats <command> --help` for options, or `whop stats <command> --schema` for full argument details.

package/skills/whop-verifications/SKILL.md

@@ -19,3 +19,7 @@ Use the Verifications API to start or resume a hosted verification session, chec
 | `whop verifications update` | Update Verification |
 
 Run `whop verifications <command> --help` for options, or `whop verifications <command> --schema` for full argument details.
+
+## Steps that finish in the browser
+
+Some commands respond with a URL the user must open in a browser to finish the flow (`authorize_url`, `session_url`, `deposit_url`) — the CLI cannot complete that step itself. When a response contains one of these fields, or the CLI prints "Action required: open this link in the user's browser", open that link in the user's browser for them, tell them what to complete there, then re-run the matching `get`/`list` command to confirm the step finished.

package/skills/whop-workforce-bounties/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: whop-workforce-bounties
+description: Paid tasks with reviewed submissions and escrowed rewards. Run `whop workforce-bounties --help` for usage details.
+requires_bin: whop
+command: whop workforce-bounties
+---
+
+A Workforce Bounty is a paid task posted by an account or user. The reward is held in escrow when the bounty publishes, workers submit proof of completed work, and each accepted submission is paid out until every winner slot fills.
+
+Use the Workforce Bounties API to list an account's bounties for reporting or dashboards, list the bounties a user can work or has participated in, and retrieve a single bounty by ID.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `whop workforce-bounties list` | List Workforce Bounties |
+| `whop workforce-bounties get` | Retrieve Workforce Bounty |
+
+Run `whop workforce-bounties <command> --help` for options, or `whop workforce-bounties <command> --schema` for full argument details.

package/dist/api-P7EWPZKG.js

@@ -1,18 +0,0 @@
-#!/usr/bin/env node
-import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
-import {
-  apps_spec_default,
-  createWhopFetch,
-  filterSpecByTag,
-  native_spec_default,
-  resolveActiveAccountId
-} from "./chunk-GKKJXDPK.js";
-import "./chunk-KFCNNWPI.js";
-export {
-  apps_spec_default as appsSpec,
-  createWhopFetch,
-  filterSpecByTag,
-  native_spec_default as nativeSpec,
-  resolveActiveAccountId
-};
-//# sourceMappingURL=api-P7EWPZKG.js.map

package/dist/api-P7EWPZKG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}