@whop/cli 0.14.3 → 0.15.0

package/skills/whop-recommended-actions/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: whop-recommended-actions
+description: Suggested next-step action chains for an account. Run `whop recommended-actions --help` for usage details.
+requires_bin: whop
+command: whop recommended-actions
+---
+
+A Recommended Action Chain is a short, ordered sequence of dashboard actions — create a product, price it, publish it — suggested for an account based on what it already has. Seeded chains come from hand-written presets; generated chains, produced per account, share the same shape.
+
+Use the Recommended Actions API to list the chains recommended for an account and to record that a chain was run. Running a chain executes nothing server-side — the client follows each step's CTA itself; the run endpoint records the `recommended_action_chain.executed` analytics event.
+
+# whop recommended-actions create
+
+Run Recommended Action
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `chain_id` | `string` | yes | Chain ID from the list endpoint, e.g. `rac_seed_start_selling_9f2c1a7b04`. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. Defaults to the API key's own account. |
+| `--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 recommended-actions list
+
+List Recommended Actions
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. Defaults to the API key's own account. |

package/skills/whop-setup-intents/SKILL.md

@@ -9,6 +9,26 @@ A Setup Intent saves a buyer's payment method for later without taking money now
 
 Poll [Retrieve status](https://docs.whop.com/api-reference/beta/setup-intents/retrieve-status) for how far the setup has got and what is outstanding. Once it reaches `succeeded` the method is on file and can be charged.
 
+# whop setup-intents return_url
+
+Update setup return URL
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `setup_intent_id` | `string` | yes | The unique identifier of the setup intent. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--return_url` | `string` | yes |  | Where the buyer continues after completing an off-site step. Must be an absolute https URL without credentials, at most 2,048 characters. |
+
+> Confirm with the user before executing this destructive command.
+
+---
+
 # whop setup-intents status
 
 Retrieve setup status

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

@@ -35,8 +35,8 @@ Create a Social Account
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--account_id` | `string` | no |  | The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account. |
-| `--platform` | `string` | yes |  | The platform to create the social account on. |
+| `--account_id` | `string` | no |  | The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account. Account API keys cannot update their own account's branding through Update Account; use a user-authenticated path. |
+| `--platform` | `string` | yes |  | The platform to create the social account on. `facebook` requires the account's `banner_image`, `logo`, and `description`; configure them with [Update Account](/api-reference/beta/accounts/update-account). |
 | `--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.

package/skills/whop-swaps/SKILL.md

@@ -18,10 +18,11 @@ Create Swap
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | yes |  | Business or user account ID (biz_* / user_*). |
-| `--amount` | `unknown` | no |  | Source token amount. Required for crypto swaps. Optional for fiat pairs: the portion of the negative to_token balance to repay, which must not exceed the debt; omit to repay the full debt. |
+| `--amount` | `unknown` | no |  | Source token amount. Required for crypto swaps. For fiat pairs: the amount of from_token to convert at the mid-market rate; omit (along with to_amount) to repay the full negative to_token balance instead. |
 | `--from_chain` | `number` | no |  | Source chain name or chain ID. Defaults to the source token's chain when omitted. |
 | `--from_token` | `string` | yes |  | Source token contract address or ticker symbol, such as "USDT". |
 | `--slippage_bps` | `number` | no |  | Maximum slippage tolerance in basis points. |
+| `--to_amount` | `unknown` | no |  | Fiat pairs only: sizes a partial repayment of the negative to_token balance, denominated in to_token. Must not exceed the debt. Mutually exclusive with amount. |
 | `--to_chain` | `number` | no |  | Destination chain name or chain ID. Defaults to the destination token's chain when omitted. |
 | `--to_token` | `string` | yes |  | Destination token contract address or ticker symbol, such as "XAUT". |
 | `--idempotency-key` | `string` | no |  | A unique key that makes this request safe to retry. See [Idempotent requests](https://docs.whop.com/developer/api/idempotency). |

package/skills/whop-transfers/SKILL.md

@@ -74,7 +74,7 @@ List Transfer Recipients
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
-| `--origin_id` | `string` | yes |  | The originating account ID, prefixed `biz_`. |
-| `--query` | `string` | no |  | Search users and accounts by name, username, or ID, in the dashboard's relevance order — this additionally requires the member:basic:read scope. Omit it to get the origin account's team members followed by your own other accounts. Complete email addresses return no matches. |
+| `--origin_id` | `string` | yes |  | The account sending the money: a company account ID (`biz_`), or a user ID (`user_`) for that user's own personal balance. |
+| `--query` | `string` | no |  | Search anyone on Whop by name or username, plus your own accounts by name or ID. Omit it to get the team around the balance, the people you follow, and your own accounts. The list is the same whether the balance belongs to a company or to you. Searching from a `biz_` origin additionally requires the member:basic:read scope. A credential scoped to a single company is the exception to the search itself: it only ever sees that company's own people. Complete email addresses return no matches. |
 | `--first` | `number` | no | `20` | Number of recipients per page. Search queries preserve the dashboard's 20-result maximum. |
 | `--after` | `string` | no |  | Cursor to fetch the page after (from page_info.end_cursor). |

package/skills/whop-users/SKILL.md

@@ -266,6 +266,7 @@ Update User
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | The account whose profile override to update. Required for API key callers. |
+| `--banner` | `unknown` | no |  |  |
 | `--bio` | `string` | no |  |  |
 | `--name` | `string` | no |  |  |
 | `--profile_picture` | `object` | no |  |  |
@@ -284,6 +285,7 @@ Update Current User
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
 | `--account_id` | `string` | no |  | When set, updates the authenticated user's profile override for this account instead of their global profile. |
+| `--banner` | `unknown` | no |  |  |
 | `--bio` | `string` | no |  |  |
 | `--name` | `string` | no |  |  |
 | `--profile_picture` | `object` | no |  |  |
@@ -301,6 +303,7 @@ Update
 
 | Flag | Type | Required | Default | Description |
 |------|------|----------|---------|-------------|
+| `--bounty_worker_onboarding_dismissed` | `boolean` | no |  | Whether the user has dismissed the first-time bounty worker onboarding. Set to `false` to show it again. |
 | `--investigation_enabled` | `boolean` | no |  | Whether investigation mode is enabled for the user. Only meaningful for staff users with investigation access. |
 
 > Confirm with the user before executing this destructive command.