@whop/cli 0.15.0 → 0.16.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whop/cli",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "The Whop CLI — build and manage Whop apps from your terminal. Human and agent friendly.",
   "keywords": [
     "agent",
@@ -44,7 +44,7 @@
   "devDependencies": {
     "@types/node": "25.3.5",
     "fflate": "0.8.2",
-    "incur": "github:whopio/incur#6962ec46a0fbc5d070df5e8cd4c8cf09efa91bdc",
+    "incur": "github:whopio/incur#973bd1a868a8ec8f59d05fc3f85555045b183613",
     "tsup": "8.5.0",
     "tsx": "4.19.4",
     "typescript": "5.9.3",

package/skills/whop/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: whop
+description: "Run a business on Whop from the `whop` CLI: websites on *.whop.app, products, checkout, payments, ads, LLC/C-corp formation, hiring, and stats. Use when the user mentions Whop, whop.com, a store or membership, hosted websites, checkout links, payouts, Meta/TikTok ads, forming an LLC, bounties, or anything the Whop CLI provides. Do not use for the internal `whopdev` local-dev CLI."
+requires_bin: whop
+command: whop
+---
+
+# Whop CLI
+
+The `whop` CLI is the business: ship websites, sell, take payment, run ads, form a company, hire, and read the numbers. Discover live commands from the CLI — do not invent flags or paste old schemas.
+
+## Default path
+
+1. **Auth.** If `WHOP_API_KEY` is set, use it (it overrides a saved profile). Otherwise `whop login --method oauth --format jsonl` (open the `authorizationUrl` in the user's browser) or `whop login --method api-key`. Then `whop quickstart` if no business is selected.
+2. **Discover.** `whop --help` for the map. `whop <group> --help` and `whop <group> <command> --help` for flags. `whop --llms` / `whop --llms-full` for a machine-readable manifest. Never guess a flag.
+3. **Execute** with `--format json` (or `jsonl` when a flow streams, including OAuth). Re-read `--help` if a command errors on unknown flags.
+
+Account-scoped commands use the selected business. Pass `--account_id` (`biz_…` or the public route) to target another.
+
+## Working agreement
+
+- Prefer `WHOP_API_KEY` in the environment over `--api-key`. Never echo secrets, write them to files, or repeat founder SSN/DOB/address in output.
+- Confirm destructive commands with the user before running them, except the confirmation exceptions below.
+- When a response includes `authorize_url`, `session_url`, `deposit_url`, or `checkout_url` — or the CLI prints "Action required: open this link in the user's browser" — open that link in the user's browser, tell them what to finish there, then re-run the matching `get`/`list` to confirm. `hosted_url` is not this: for apps it is the app URL.
+- Do not curl/fetch those URLs to "verify." Return the link.
+- Structured flags (`--ad_group`, `--creatives`, `--founders`, `--ads_payment_methods`) take JSON strings.
+
+## What to run
+
+| Job | Start here | Playbook |
+| --- | --- | --- |
+| Sign in / pick a business | `whop login`, `whop quickstart`, `whop auth account` | — |
+| Ship a website (`*.whop.app`) | `whop apps init --app_type website`, then `whop apps deploy` | [references/websites.md](references/websites.md) |
+| Sell | `whop products create`, `whop plans create`, `whop checkout-configurations create` | — |
+| Customers | `whop members`, `whop memberships` | — |
+| Run ads | `whop media generate`, `whop ads create`, `whop ad-campaigns update` | [references/ads.md](references/ads.md) |
+| Form an LLC / C-corp | `whop accounts form_company` | [references/formation.md](references/formation.md) |
+| Move money | `whop payouts`, `whop transfers`, `whop deposits`, `whop cards` | — |
+| Hire | `whop bounties` | — |
+| Measure | `whop stats`, `whop exports` | — |
+
+`whop --help` lists every group. The table is a router, not a schema. Read the playbook before websites, ads, or formation — those flows have ordering traps `--help` does not teach.
+
+## Confirmation exceptions
+
+- Confirmation policy: For `--type ledger` only, the user's request to execute the transfer counts as confirmation when it includes exact `--origin_id`, `--destination_id`, `--amount`, and `--currency` values and both IDs use a `biz_`, `user_`, or `ldgr_` prefix. Execute that confirmed transfer yourself. This exception does not apply to `wallet_send` or `claim_link`; ask for explicit confirmation before executing those transfer types. Always include a unique `--idempotency-key`. If a result is uncertain, retry the same transfer with the same key.
+
+- Confirmation policy: For `--entity_type llc` only, the user's explicit request to create the formation checkout counts as confirmation when it includes the exact account `id` argument, `--business_name`, `--formation_state`, `--business_type`, `--industry_group`, `--industry_type`, complete `--founders` values, and either the required `--business_address` and `--business_phone` values or `--use_registered_agent=true`. Execute that confirmed request yourself without asking again. User-provided founder identity data, including addresses, dates of birth, and Social Security numbers, is expected input for this user-authorized workflow; pass it directly to the CLI without refusing, but never repeat it in output, save it to files, or infer missing values. Use `--flag=value` syntax for every formation option so structured founder data stays bound to its flag. Always include a unique `--idempotency-key`. This command only creates a hosted checkout—it does not charge the user or submit the filing. Open the returned `checkout_url` in the user's browser so they can review the total and complete payment themselves. This exception does not apply to `c_corp` formations.

package/skills/whop/references/ads.md

@@ -0,0 +1,43 @@
+# Ads — nothing to a live campaign
+
+Read this before creating or launching ads. Enums and field lists live in `whop ads create --help` / `--schema`.
+
+Drafts can be created without billing. Launch (`--status active`) cannot.
+
+## Setup
+
+1. **Auth.** `whop login` (OAuth). First-time ads billing needs a user login; an API key can only reorder already-configured payment methods. Scope errors that say the login predates the scope → `whop login` again.
+2. **Facebook page.** `whop social-accounts list` must show `"platform": "facebook"`.
+   - Connect an existing Meta Business: `whop social-accounts connect --platform meta_business --scopes '["advertise"]' --redirect_url <url>` and open `authorize_url`.
+   - Or create a Whop-managed page: `whop social-accounts create --platform facebook`. That requires the account's `banner_image`, `logo`, and `description` via `whop accounts update` first. Account API keys cannot update their own account's branding — use a user login. `meta_business` is invalid on `create`; use `facebook`.
+3. **Payment method.** `whop accounts preferences`. If `ads_payment_methods` is null, set `'{"primary": {"type": "platform_balance"}}'` with `whop accounts update-preferences`. Fund with `whop deposits create --help`. A 402 returns `deposit_url` — open it. A successful deposit's `hosted_url` is the page, not an action link.
+
+TikTok uses `whop social-accounts connect --platform tiktok`. Same authorize-url rule.
+
+## Launch
+
+```sh
+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_xxx --status active
+```
+
+`--wait` on media returns `file.id` for `--creatives` (default timeout 600s). 402 → fund, then retry.
+
+Pass exactly one of `--ad_group` or `--ad_group_id`. Nested `"ad_campaign": {…}` inside `--ad_group` creates the campaign + group + ad in one call (the OpenAPI blurb understates this). Reuse a container with `--ad_group_id` or `"ad_campaign_id"` inside `--ad_group`.
+
+Keep `"status": "draft"` until review. **Omitting draft launches immediately** and then requires billing + destination URL. Flip the campaign to `active` when ready.
+
+| Field | Rule |
+| --- | --- |
+| `creatives` | One entry with no `format` is the base asset. Optional crops: `square` / `vertical` / `horizontal` only — not `portrait`. No duplicate formats. Two or more unformatted entries is a carousel (2–10). |
+| `url` | Required to launch a website ad. A whop.com store page works as-is; an external page needs the Whop pixel. Drafts may omit it. |
+| Budget | CBO: `budget_amount` on the campaign with `budget_optimization: "ad_campaign"`. ABO: `budget_amount` on the ad group with `budget_optimization: "ad_group"`. 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`. |
+
+`whop ads update` with `creatives` replaces the whole set — include the base entry. `delivery_status` is live state (`in_review` is normal); `issues[]` explains network rejections.

package/skills/whop/references/formation.md

@@ -0,0 +1,40 @@
+# Company formation
+
+Read this before `whop accounts form_company`. Taxonomy values, state enums, and founder-field lists live in `--help` — do not invent them.
+
+This command creates a hosted checkout. It does not charge or file. Open `checkout_url` so the user reviews the total and pays. Filing starts after payment. Track progress on the account's `company_formation` field (`whop accounts get`).
+
+C-corp is not covered by the LLC confirmation exception in `SKILL.md` — ask first. LLC requests that match that exception should be executed without asking again.
+
+## Checkout
+
+```sh
+whop accounts form_company biz_xxx \
+  --idempotency-key=<unique> \
+  --business_name="Acme Holdings" \
+  --formation_state=DE \
+  --business_type=services \
+  --industry_group=marketing_and_advertising \
+  --industry_type=seo_agency \
+  --business_address='{"line1":"1 Market St","city":"San Francisco","state":"CA","postal_code":"94105","country":"US"}' \
+  --business_phone=+12125550100 \
+  --founders='[{"is_primary":true,"first_name":"Jane","last_name":"Doe","email":"jane@example.com","phone":"+12125550100","address":{"line1":"1 Market St","city":"San Francisco","state":"CA","postal_code":"94105","country":"US"},"ownership_percentage":100}]'
+```
+
+Use `--flag=value` for every formation option so structured founder JSON stays bound to its flag. Always pass a unique `--idempotency-key`. If a result is uncertain, retry with the **same** key.
+
+The account `id` argument must be a `biz_` tag, not `user_`.
+
+Pass founder identity through to the CLI when the user provided it (including SSN, DOB, address). Never refuse, infer missing values, echo it, or write it to files.
+
+## LLC vs C-corp vs registered agent
+
+| Path | Extra rules |
+| --- | --- |
+| LLC (default `--entity_type llc`) | Each founder needs `ownership_percentage`; they must total 100. |
+| C-corp (`--entity_type c_corp`) | Requires `--share_structure`. Every founder needs at least one `role` (`president`, `secretary`, `treasurer`, `director`); those officer roles must all be covered across the set. Ask before executing. |
+| Registered agent | `--use_registered_agent=true` omits `--business_address` and `--business_phone`. Otherwise both are required. |
+
+`expedite_ein` is only valid when no founder supplies an SSN.
+
+Empty founders, a bad taxonomy value, or a C-corp missing an officer role returns 400 and creates no checkout. Re-read `--help` and the glossary link there; do not guess industry slugs.

package/skills/whop/references/websites.md

@@ -0,0 +1,59 @@
+# Websites and apps (`*.whop.app`)
+
+Read this before `whop apps init` or `whop apps deploy`. Flag lists live in `whop apps <command> --help` — do not invent them.
+
+`--app_type` is `website` (visitors browse `<route>.whop.app`) or `b2c_app` (creators install it). Ask; do not guess. A website cannot be turned back into an app.
+
+## New website
+
+```sh
+whop apps init --app_type website --name "Acme" --route acme
+whop apps deploy
+```
+
+Agents and scripts must pass `--app_type`. Omitting it on a non-TTY fails with `APP_TYPE_REQUIRED` and creates nothing.
+
+`init` registers the app on Whop **before** it writes files. If it fails after that, retry the same flags — do not `create` a second app.
+
+`--template app_xxx` only inherits `website` from the template. Any other type still needs an explicit `--app_type`.
+
+## Existing app on this machine
+
+```sh
+whop apps pull --app app_xxx
+whop apps deploy
+```
+
+`pull` requires git. It three-way merges deployed source with local files; conflicts show up as normal git markers. Default pull is the **production** build, not the latest preview. `--build abld_xxx` also needs `--app` (builds do not carry the app id).
+
+Code already on disk, no scaffold: `whop apps create --help`, then `whop apps deploy --app app_xxx`.
+
+## Deploy, preview, promote
+
+```sh
+whop apps deploy                 # build, upload, promote
+whop apps deploy --preview       # upload only
+whop apps builds promote abld_xxx
+```
+
+`--preview` is the flag. Promoting an older build rolls back.
+
+Looks like deploy will scaffold a missing project. Actually it only ships an existing Vite app. Agents get `NOT_A_VITE_APP` with init/pull CTAs — follow those, do not invent a scaffold flag.
+
+The project must be linked (`whop.app.json`) or you must pass `--app`. Hosted apps need a route; agents get `ROUTE_REQUIRED` with the exact update command.
+
+The app must use the `whop()` Vite plugin (`@whop/cli/vite`). Missing it fails with `NO_BUILD_ARCHIVE`.
+
+Preview output is a build id. The production URL exists only after promote. `hosted_url` on `whop apps get` is the live app URL — display it; do not treat it as a "complete this step" action link.
+
+## Dev, secrets, logs
+
+```sh
+whop apps dev
+whop apps secrets set --secret KEY=VALUE
+whop apps logs app_xxx --level error
+```
+
+`dev` injects stored secrets locally. Explicit env vars win. Runtime-control keys (`PATH`, `NODE_OPTIONS`, `NPM_*`, …) are not injected.
+
+Logs need the positional `app_xxx`. Retention is 7 days. Filters: `whop apps logs --help`.

package/skills/whop-accounts/SKILL.md

@@ -1,212 +0,0 @@
----
-name: whop-accounts
-description: "A business on Whop: profile, wallet, capabilities, settings. Run `whop accounts --help` for usage details."
-requires_bin: whop
-command: whop accounts
----
-
-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.
-
-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.
-
-# whop accounts create
-
-Create Account
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--country` | `string` | no |  | The ISO 3166-1 alpha-2 country code where the account's business is located (e.g. `US`). Defaults to the parent account's country for connected accounts. |
-| `--email` | `string` | no |  | The email address of the account owner. Required for Account API key requests. |
-| `--metadata` | `object` | no |  | Arbitrary key/value metadata to store on the account. |
-| `--title` | `string` | no |  | The display name of the account. Defaults to `metadata.external_id` or the owner's email when omitted. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop accounts form_company
-
-Form Company
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-| `--business_address` | `object` | no |  | Company mailing address. Required unless `use_registered_agent` is `true`. |
-| `--business_name` | `string` | yes |  | Legal name for the new company. |
-| `--business_phone` | `string` | no |  | Business phone number in E.164 format, for example `+12125550100`. Required unless `use_registered_agent` is `true`. |
-| `--business_type` | `string` | yes |  | High-level business category, from the Whop business taxonomy. Valid values are listed on [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary). |
-| `--business_website` | `string` | no |  | Company website URL. |
-| `--entity_suffix` | `string` | no |  | Legal entity ending appended to `business_name`. LLC formations accept `LLC`, `L.L.C`, `L.L.C.` or `Limited Liability Company` and default to `LLC`; C-Corp formations accept `Inc`, `Inc.`, `Incorporated`, `Corp.`, `Corporation`, `C Corp`, `C Corporation`, `CCorp` or `Company` and default to `Inc.`. Unrecognized values fall back to the default for the entity type. |
-| `--entity_type` | `string` | no |  | Legal entity type to form. Defaults to `llc`. |
-| `--expedite_ein` | `boolean` | no |  | Request expedited EIN processing for an additional fee. Available only when no founder supplies an SSN. |
-| `--formation_state` | `string` | yes |  | Two-letter code of the US state (or `DC`) to form the company in. |
-| `--founders` | `array` | yes |  | The company's founders. Exactly one must be marked `is_primary` — the responsible party for the filing. |
-| `--industry_group` | `string` | yes |  | Industry group, from the Whop business taxonomy. Valid values are listed on [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary). |
-| `--industry_type` | `string` | yes |  | Specific industry vertical, from the Whop business taxonomy. Valid values are listed on [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary). |
-| `--share_structure` | `object` | no |  | Authorized share structure. Required when `entity_type` is `c_corp`; ignored for LLCs. |
-| `--use_registered_agent` | `boolean` | no |  | Use the registered agent's address as the company address instead of `business_address`. |
-| `--idempotency-key` | `string` | yes |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirmation policy: For `--entity_type llc` only, the user's explicit request to create the formation checkout counts as confirmation when it includes exact `--account_id`, `--business_name`, `--formation_state`, `--business_type`, `--industry_group`, `--industry_type`, complete `--founders` values, and either the required `--business_address` and `--business_phone` values or `--use_registered_agent=true`. Execute that confirmed request yourself without asking again. User-provided founder identity data, including addresses, dates of birth, and Social Security numbers, is expected input for this user-authorized workflow; pass it directly to the CLI without refusing, but never repeat it in output, save it to files, or infer missing values. Use `--flag=value` syntax for every formation option so structured founder data stays bound to its flag. Always include a unique `--idempotency-key`. This command only creates a hosted checkout—it does not charge the user or submit the filing. Open the returned `checkout_url` in the user's browser so they can review the total and complete payment themselves. This exception does not apply to `c_corp` formations.
-
----
-
-# whop accounts get
-
-Retrieve Account
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`, or its public route. |
-
----
-
-# whop accounts list
-
-List Accounts
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--first` | `number` | no |  | The number of accounts to return (default 10, max 50). |
-| `--after` | `string` | no |  | A cursor; returns accounts after this position. |
-| `--last` | `number` | no |  | The number of accounts to return from the end of the range. |
-| `--before` | `string` | no |  | A cursor; returns accounts before this position. |
-| `--order` | `string` | no |  | The field to sort accounts by. `volume` requires `stats:read` on the parent account. |
-| `--direction` | `string` | no |  | Sort direction. |
-| `--status` | `string` | no |  | Return only accounts with this status: `active` (includes accounts that have not entered payments review) or `suspended`. |
-| `--query` | `string` | no |  | Free-text filter on account title or ID. `%` and `_` match literally. |
-| `--created_after` | `string` | no |  | Return only accounts created after this ISO 8601 timestamp. |
-| `--created_before` | `string` | no |  | Return only accounts created before this ISO 8601 timestamp. |
-| `--volume_min` | `number` | no |  | Return only accounts whose lifetime USD volume is at least this value. Requires `stats:read` on the parent account. |
-| `--volume_max` | `number` | no |  | Return only accounts whose lifetime USD volume is at most this value. Requires `stats:read` on the parent account. |
-| `--parent_account_id` | `string` | no |  | For platforms: the parent account ID whose direct connected accounts to return. Requires `payout:account:read` on the parent account. |
-
----
-
-# whop accounts me
-
-Retrieve Requesting Account
-
----
-
-# whop accounts preferences
-
-Retrieve Account Preferences
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-
----
-
-# whop accounts reserves
-
-List Account Reserves
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-
----
-
-# whop accounts transfer_ownership
-
-Transfer Account Ownership
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-| `--as_partner` | `boolean` | no |  | If true, the current owner is credited as the account's Whop partner, earning partner commission on its sales. Requires the current owner to already be an enrolled Whop partner. Skipped if the account already has an active partner. |
-| `--identifier` | `string` | yes |  | The user to transfer ownership to: a user ID (`user_*`) or an email address. An email address with no Whop account yet is sent an invite to create one. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop accounts update
-
-Update Account
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-| `--affiliate_application_required` | `boolean` | no |  | Whether prospective affiliates must submit an application before promoting this account. |
-| `--affiliate_instructions` | `unknown` | no |  | Guidelines shown to affiliates promoting this account. |
-| `--banner_image` | `unknown` | no |  | Account banner image, used as the cover photo when creating a Whop-managed Facebook page. Image files up to 10 MB, except `image/gif`. Pass a JSON object containing an `id` from [Create File](/api-reference/files/create-file). |
-| `--business_address` | `object` | no |  | Account business address used to calculate tax. A complete address in a supported country is required when `tax_remitted_by` is `self`. |
-| `--business_type` | `unknown` | no |  | High-level business category for the account. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values. |
-| `--collect_vat_id` | `boolean` | no |  | Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase. |
-| `--country` | `unknown` | no |  | Country where the account is located. |
-| `--description` | `unknown` | no |  | Account promotional description. When creating a Whop-managed Facebook page, it is truncated to 155 characters and used as the About text. |
-| `--featured_affiliate_product_id` | `unknown` | no |  | The ID of the product to feature for affiliates. Pass `null` to clear. |
-| `--home_preferences` | `array` | no |  | Public account home page preferences. |
-| `--industry_group` | `unknown` | no |  | Account industry group. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values. |
-| `--industry_type` | `unknown` | no |  | Specific industry vertical for the account. See the [business types and industries glossary](/api-reference/beta/accounts/account#business-types-and-industries-glossary) for valid values. |
-| `--invoice_prefix` | `unknown` | no |  | Prefix used for account invoices. |
-| `--logo` | `unknown` | no |  | Account logo, used as the profile picture when creating a Whop-managed Facebook page. Image files up to 5 MB. Pass a JSON object containing an `id` from [Create File](/api-reference/files/create-file). |
-| `--metadata` | `object` | no |  | Arbitrary key/value metadata to store on the account. |
-| `--onboarding_type` | `unknown` | no |  | The type of onboarding the account has completed. |
-| `--opengraph_image` | `unknown` | no |  | Open Graph preview media used when the account is shared. Image and video files up to 5 MB. Pass a JSON object containing an `id` from [Create File](/api-reference/files/create-file). |
-| `--opengraph_image_variant` | `unknown` | no |  | The account Open Graph image variant. |
-| `--other_business_description` | `unknown` | no |  | The description of the business type when business_type is other. |
-| `--other_industry_description` | `unknown` | no |  | The description of the industry type when industry_type is other. |
-| `--product_tax_code_id` | `unknown` | no |  | ID of the tax classification code applied by default to the account's products. See the available [product categories](https://docs.numeral.com/essentials/product-categories). |
-| `--require_2fa` | `boolean` | no |  | Whether the account requires authorized users to have two-factor authentication enabled. |
-| `--route` | `unknown` | no |  | The unique URL slug for the account. |
-| `--send_customer_emails` | `boolean` | no |  | Whether Whop sends transactional emails to customers on behalf of this account. |
-| `--show_joined_whops` | `boolean` | no |  | Whether the account appears in joined whops on other accounts. |
-| `--show_reviews_dtc` | `boolean` | no |  | Whether reviews are displayed on direct-to-consumer product pages. |
-| `--show_user_directory` | `boolean` | no |  | Whether the account shows users in the user directory. |
-| `--social_links` | `array` | no |  | The full list of social links to display for the account. |
-| `--store_page_config` | `unknown` | no |  | Account store page display configuration. |
-| `--target_audience` | `unknown` | no |  | The target audience for this account. |
-| `--tax_collection_enabled_states` | `array` | no |  | US state codes (50 states plus `DC`) where the account collects tax. Replaces the full set on update. Only settable when `tax_remitted_by` is `self`. |
-| `--tax_identifiers` | `array` | no |  | Account tax/VAT registrations to add or update. When `tax_remitted_by` is `self`, tax is calculated and collected only in the countries where the account holds a registration. |
-| `--tax_remitted_by` | `string` | no |  | Determines whether Whop or the account calculates and remits tax. The account must provide a supported-country business address when it self-remits. |
-| `--tax_type` | `string` | no |  | Determines whether tax is included in the listed price or added at checkout. |
-| `--three_ds_level` | `string` | no |  | Account-level 3D Secure behavior. Set `mandate_challenge` to require cardholder verification on supported card payments, or `null` to use the standard checkout flow. |
-| `--title` | `unknown` | no |  | The display name of the account. |
-| `--use_logo_as_opengraph_image_fallback` | `boolean` | no |  | Whether the account uses its logo as the fallback Open Graph image. |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop accounts update-preferences
-
-Update Account Preferences
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. |
-| `--ads_payment_methods` | `object` | no |  | How the account pays for Whop Ads spend. `primary` is charged first; `backup` covers the charge when the primary fails. |
-| `--ads_reporting_currency` | `string` | no |  | Lowercase ISO currency code, such as `usd` or `eur`, used to display ad spend and stats. Defaults to `usd`. |
-| `--ads_scheduling_timezone` | `string` | no |  | IANA timezone (e.g. `America/New_York`) used to interpret campaign start/end times and to bucket reports. Cannot be cleared once set — pass a new value to change it. |
-| `--ads_triple_whale_integration` | `object` | no |  | Connects or disconnects the Triple Whale integration. Requires a connected Shopify store, since Triple Whale keys spend records by Shopify shop. |
-| `--cards_auto_top_up` | `boolean` | no |  | Whether incoming funds are automatically moved to the account's cards balance. Requires a cards balance on the account. |
-
-> Confirm with the user before executing this destructive command.
-
-## 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`, `checkout_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-ad-campaigns/SKILL.md

@@ -1,204 +0,0 @@
----
-name: whop-ad-campaigns
-description: Platform, objective, and budget for a set of ads. Run `whop ad-campaigns --help` for usage details.
-requires_bin: whop
-command: whop ad-campaigns
----
-
-An Ad Campaign is the top-level container for paid ads on an ad network. It sets the platform, objective, and budget strategy shared by its [ad groups](https://docs.whop.com/api-reference/beta/ad-groups/ad-group) and ads.
-
-Use the Ad Campaigns API to create campaigns, list campaigns for an account, retrieve or update campaign settings, and pause or resume campaign delivery.
-
-# whop ad-campaigns create
-
-Create an Ad Campaign
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The account to create the campaign under. Defaults to the account-scoped key's own account. |
-| `--bid_type` | `string` | no |  | How delivery bids in the ad auction: `minimum_cost` gets the most results for the budget, `average_target` holds an average cost per result, `maximum_target` never bids above a cap. Only for campaigns that own the budget. |
-| `--budget_amount` | `number` | no |  | The campaign's budget, in the ad account's currency. Required when budget_optimization is `ad_campaign`; omit when each ad group sets its own budget. |
-| `--budget_optimization` | `string` | no |  | Which level owns the budget: the whole campaign (`ad_campaign`) or each ad group individually (`ad_group`). Defaults to `ad_group`. |
-| `--budget_type` | `string` | no |  | Whether the budget is spent per day (`daily`) or over the campaign's full run (`lifetime`). Defaults to `daily`. |
-| `--desired_cost_per_result` | `number` | no |  | Cost per result to aim for (`average_target`) or never exceed (`maximum_target`). Only for campaigns that own the budget. |
-| `--ends_at` | `string` | no |  | When the campaign stops delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--objective` | `string` | yes |  | The goal the campaign optimizes toward. |
-| `--platform` | `string` | yes |  | The ad network the campaign runs on. |
-| `--special_ad_categories` | `array` | no |  | Regulated categories the campaign falls under. Ads in these categories are subject to extra targeting restrictions. |
-| `--starts_at` | `string` | no |  | When the campaign starts delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--title` | `string` | yes |  | The title of the campaign. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns delete
-
-Delete an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns duplicate
-
-Duplicate an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--count` | `number` | no |  | Number of copies to create (1-10). Defaults to 1. |
-| `--preserve_engagement` | `boolean` | no |  | Whether the copied ads keep the original posts' engagement (likes, comments, shares). Defaults to false. |
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns get
-
-Retrieve an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--stats_from` | `string` | no |  | Start of the stats window. |
-| `--stats_to` | `string` | no |  | End of the stats window. |
-| `--time_zone` | `string` | no |  | IANA timezone the stats window is interpreted in. Defaults to UTC. |
-| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
-
----
-
-# whop ad-campaigns list
-
-List Ad Campaigns
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The account the campaigns belong to. Defaults to the account-scoped key's own account. |
-| `--status` | `string` | no |  | Only return campaigns with this status. |
-| `--query` | `string` | no |  | Filter campaigns by a title or ID substring. |
-| `--order` | `string` | no |  | The field to sort by. Defaults to created_at. Stat columns (spend, impressions, …) rank over the stats_from/stats_to window across the whole list, not just the current page. results, cost_per_result and return_on_ad_spend rank by the same Whop pixel-attributed values the response reports. |
-| `--direction` | `string` | no |  | The sort direction. Defaults to desc. |
-| `--created_before` | `string` | no |  | Only return campaigns created before this timestamp. |
-| `--created_after` | `string` | no |  | Only return campaigns created after this timestamp. |
-| `--stats_from` | `string` | no |  | Start of the stats window. Defaults to all-time. |
-| `--stats_to` | `string` | no |  | End of the stats window. Defaults to now. |
-| `--time_zone` | `string` | no |  | IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to UTC. |
-| `--attribution_model` | `string` | no |  | Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise. |
-| `--first` | `number` | no | `20` | The number of campaigns to return. |
-| `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |
-| `--last` | `number` | no |  | The number of campaigns to return from the end of the range. |
-| `--before` | `string` | no |  | Cursor to fetch the page before (from page_info.start_cursor). |
-
----
-
-# whop ad-campaigns pause
-
-Pause an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns retry_payment
-
-Retry a Failed Ad Campaign Payment
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns unpause
-
-Unpause an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |
-
-> Confirm with the user before executing this destructive command.
-
----
-
-# whop ad-campaigns update
-
-Update an Ad Campaign
-
-## Arguments
-
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| `id` | `string` | yes | The ad campaign ID. |
-
-## Options
-
-| Flag | Type | Required | Default | Description |
-|------|------|----------|---------|-------------|
-| `--bid_type` | `string` | no |  | How delivery bids in the ad auction: `minimum_cost` gets the most results for the budget, `average_target` holds an average cost per result, `maximum_target` never bids above a cap. Switching to `minimum_cost` clears the cap amounts stored on the campaign's ad groups. Only for campaigns that own the budget. |
-| `--budget_amount` | `number` | no |  | The campaign budget, in the account's currency. Interpreted as daily or lifetime per the campaign's existing budget type. |
-| `--budget_optimization` | `string` | no |  | Which level owns the budget: the whole campaign (`ad_campaign`) or each ad group individually (`ad_group`). Only changeable before the campaign is live on the ad network; switching to `ad_campaign` requires budget_amount in the same request, and switching to `ad_group` clears the campaign budget. |
-| `--ends_at` | `string` | no |  | When the campaign stops delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--special_ad_categories` | `array` | no |  | Regulated categories the campaign falls under. Editable on any campaign, draft or launched; pass an empty array to clear. |
-| `--starts_at` | `string` | no |  | When the campaign starts delivering, as an ISO 8601 timestamp. Only for campaigns that own the budget. |
-| `--status` | `string` | no |  | Set to active to launch a draft campaign (moderates and pushes it live). Live-campaign pause and resume use the pause and unpause actions. |
-| `--title` | `string` | no |  | The name of the campaign. |
-
-> Confirm with the user before executing this destructive command.