@whop/cli 0.14.1 → 0.14.2

package/skills/whop-exports/SKILL.md

@@ -9,12 +9,334 @@ An Export is an asynchronous CSV of one resource for one account — members, pa
 
 Use the Exports API to start an export, poll it until `download_url` is set, and list the exports already requested for an account. Finished CSVs are retained for 30 days, after which the file is deleted and the export moves to `expired`.
 
-## Commands
+# whop exports create
 
-| Command | Description |
-|---------|-------------|
-| `whop exports list` | List Exports |
-| `whop exports create` | Create Export |
-| `whop exports get` | Retrieve Export |
+Create Export
 
-Run `whop exports <command> --help` for options, or `whop exports <command> --schema` for full argument details.
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | The account to export from, prefixed `biz_`. Defaults to the credential's account. |
+| `--columns` | `array` | no |  | Column keys to include. Empty means all columns for the resource. |
+| `--filters` | `object` | no |  | Resource-specific filters. For native REST resources (`payouts`, `transfers`, `memberships`) these are the resource's own list query params; for dashboard tables they mirror the dashboard table filters.
+
+<details>
+<summary>Filters by resource (22)</summary>
+
+<details>
+<summary>ad_campaigns (4)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/ad_campaigns`.
+
+- `created_after` `string` — Only return campaigns created after this timestamp.
+- `created_before` `string` — Only return campaigns created before this timestamp.
+- `query` `string` — Filter campaigns by a title or ID substring.
+- `status` `string` — Only return campaigns with this status. One of `draft`, `active`, `paused`, `payment_failed`.
+
+</details>
+<details>
+<summary>ad_groups (6)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/ad_groups`.
+
+- `ad_campaign_id` `string` — Filter to ad groups in this campaign.
+- `ad_campaign_ids` `string[]` — Filter to ad groups in these campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b).
+- `created_after` `string` — Only return ad groups created after this timestamp.
+- `created_before` `string` — Only return ad groups created before this timestamp.
+- `query` `string` — Filter ad groups by a title or ID substring.
+- `status` `string` — Filter to ad groups with this status. One of `active`, `paused`, `rejected`, `duplicating`.
+
+</details>
+<details>
+<summary>ads (8)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/ads`.
+
+- `ad_campaign_id` `string` — Only return ads in this ad campaign.
+- `ad_campaign_ids` `string[]` — Only return ads in these ad campaigns (max 100). Repeat the parameter for each id (ad_campaign_ids=a&ad_campaign_ids=b).
+- `ad_group_id` `string` — Only return ads in this ad group.
+- `ad_group_ids` `string[]` — Only return ads in these ad groups (max 100). Repeat the parameter for each id (ad_group_ids=a&ad_group_ids=b).
+- `created_after` `string` — Only return ads created after this timestamp.
+- `created_before` `string` — Only return ads created before this timestamp.
+- `query` `string` — Filter ads by a title or ID substring.
+- `status` `string` — Only return ads with this status. One of `active`, `paused`, `in_review`, `rejected`.
+
+</details>
+<details>
+<summary>audiences (3)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/audiences`.
+
+- `audience_id` `string` — Audience ID, prefixed `adaud_`, used to filter the response to one audience.
+- `audience_type` `string` — Filter by audience type: `custom` (uploaded lists) or `lookalike`. One of `custom`, `lookalike`.
+- `source_type` `string` — Filter by member source: `csv_upload` (uploaded lists) or `people_filter` (automatic audiences built from saved People filters). One of `csv_upload`, `people_filter`.
+
+</details>
+<details>
+<summary>bounties (5)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/bounties`.
+
+- `created_after` `string` — Only bounties created after this ISO 8601 timestamp.
+- `created_before` `string` — Only bounties created before this ISO 8601 timestamp.
+- `query` `string` — Substring match on the bounty title or ID.
+- `status` `string` — Filter by lifecycle state. One of `scheduled`, `open`, `closed`, `completed`, `canceled`.
+- `user_id` `string` — List the bounties this user participated in (`user_` tag). Must be the authenticated user.
+
+</details>
+<details>
+<summary>bounty_submissions (4)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/bounty_submissions`.
+
+- `bounty_id` `string` — Only submissions on this bounty (`bnty_` tag).
+- `created_after` `string` — Only submissions created after this ISO 8601 timestamp.
+- `created_before` `string` — Only submissions created before this ISO 8601 timestamp.
+- `status` `string` — Filter by lifecycle state. One of `in_progress`, `submitted`, `approved`, `denied`.
+
+</details>
+<details>
+<summary>disputes (4)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/disputes`.
+
+- `created_after` `string` — Only disputes opened after this ISO 8601 timestamp.
+- `created_before` `string` — Only disputes opened before this ISO 8601 timestamp.
+- `currency` `string` — Only disputes in this three-letter ISO currency.
+- `status` `string[]` — Only disputes in these statuses. Repeat the parameter to pass several — one paginated list covers all of them. Covers both chargebacks and inquiries at each stage.
+
+</details>
+<details>
+<summary>events (14)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/events`.
+
+- `attribution_model` `string` — Attribution model for the source filter (defaults to last_touch). One of `last_touch`, `first_touch`.
+- `browser` `string` — Browser families to filter by, comma-separated (e.g. Chrome, Mobile Safari).
+- `city` `string` — Cities to filter by, comma-separated.
+- `country` `string` — Country codes to filter by, comma-separated.
+- `device` `string` — Device families to filter by, comma-separated (e.g. iPhone, Mac).
+- `event` `string` — Full event names to filter by, comma-separated (payment.completed, pixel.lead, pixel.page, pixel.custom:<name>) — the same vocabulary the events / people metrics use.
+- `from` `string` — Start of the time range as an ISO 8601 timestamp. Required when identifier is omitted.
+- `hostname` `string` — Page hostnames to filter by, comma-separated.
+- `identifier` `string` — Any hard identifier of the person: a person ID (prsn_*), user ID, email, phone number, or a tracking cookie value (wuid, anonymous ID, fbp/fbc/ttp/ga). Omit to list recent events for the account.
+- `os` `string` — Operating system families to filter by, comma-separated (e.g. iOS, Windows).
+- `page` `string` — Page paths to filter by, comma-separated.
+- `source` `string` — Canonical source path, exact or with a trailing :* prefix (whop:<campaign>:*, ext:meta:*, referrer:<domain>, direct). Restricts the list to conversion targets attributed to that source — the debuggability twin of a metric cell's source parameter.
+- `to` `string` — End of the time range as an ISO 8601 timestamp. Required when identifier is omitted; otherwise defaults to now.
+- `utm_source` `string` — utm_source values to filter by, comma-separated.
+
+</details>
+<details>
+<summary>financial-activity (8)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/financial-activity`.
+
+- `available_after` `string` — Only include rows whose funds became withdrawable on or after this `YYYY-MM-DD` settlement date (UTC), distinct from posted_at. Requires currency.
+- `available_before` `string` — Only include rows whose funds became withdrawable on or before this `YYYY-MM-DD` settlement date (UTC). Set equal to available_after for a single day. Requires currency.
+- `currency` `string` — Optional currency code filter, for example `usd`.
+- `include_owned_accounts` `boolean` — When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning `account`.
+- `line_types` `string[]` — Optional ledger line categories to include. Some categories (for example `onchain_deposit`, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here.
+- `posted_after` `string` — Only include rows posted after this ISO 8601 timestamp.
+- `posted_before` `string` — Only include rows posted before this ISO 8601 timestamp.
+- `user_id` `string` — The owning user ID (a user_ identifier). Provide this or account_id.
+
+</details>
+<details>
+<summary>members (5)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/members`.
+
+- `access_level` `string` — Filter by what the member can reach on the account. One of `no_access`, `admin`, `customer`.
+- `created_after` `string` — Only members who joined after this ISO 8601 timestamp.
+- `created_before` `string` — Only members who joined before this ISO 8601 timestamp.
+- `query` `string` — Search members by name or username. An exact email address also matches when the credential holds the member:email:read scope.
+- `status` `string` — Filter by whether the member is still part of the account. One of `joined`, `left`.
+
+</details>
+<details>
+<summary>memberships (6)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/memberships`.
+
+- `created_after` `string` — Only memberships created after this ISO 8601 timestamp.
+- `created_before` `string` — Only memberships created before this ISO 8601 timestamp.
+- `plan_id` `string` — Filter to memberships of this plan (`plan_` tag). Repeat as plan_ids[] for several.
+- `product_id` `string` — Filter to memberships of this product (`prod_` tag). Repeat as product_ids[] for several.
+- `status` `string` — Filter by billing state. `canceling` matches active memberships set to cancel at period end; `paused` matches memberships with payment collection paused. One of `active`, `trialing`, `past_due`, `completed`, `canceled`, `expired`, `canceling`, `paused`.
+- `user_id` `string` — Narrow to one user's memberships (`user_` tag, or `me` for the caller). A user outside the caller's visible set returns an empty list.
+
+</details>
+<details>
+<summary>payouts (2)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/payouts`.
+
+- `currency` `string` — Optional currency code filter, for example `usd`.
+- `user_id` `string` — The owning user ID (a user_ identifier). Provide this or account_id.
+
+</details>
+<details>
+<summary>people (20)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/people`.
+
+- `attribution_model` `string` — Attribution model the source filter matches against (defaults to last_touch). One of `last_touch`, `first_touch`.
+- `audience_id` `string` — Only include people in this audience. An audience that keeps itself up to date resolves to the People filters that define it, so this always reflects who matches now; uploaded lists and point-in-time snapshots match their recorded members.
+- `contactable` `boolean` — true for people who have an email address or phone number — the ones an ad platform can match.
+- `country` `string` — Only include people whose most recent visit came from this ISO 3166-1 alpha-2 country code.
+- `custom_event` `string` — Only include people who fired this custom pixel event.
+- `email` `string` — Only include the person linked to this email address.
+- `event_from` `string` — With event_to plus an event or source filter, switches to exact-population mode: person ids are resolved and paginated on the events side within this window (the same query the people metric counts), then hydrated per page.
+- `event_name` `string[]` — Only include people who fired any of these events, e.g. payment.completed or page.checkout.view.
+- `event_to` `string` — The inclusive end of the event window for exact-population mode.
+- `first_seen_after` `string` — Only include people first seen at or after this ISO 8601 timestamp.
+- `first_seen_before` `string` — Only include people first seen before this ISO 8601 timestamp.
+- `first_seen_within_days` `integer` — Only include people first seen within this many days, as a rolling window.
+- `has_purchased` `boolean` — true for customers only, false for people who have never purchased.
+- `last_seen_after` `string` — Only include people last seen at or after this ISO 8601 timestamp.
+- `last_seen_before` `string` — Only include people last seen before this ISO 8601 timestamp.
+- `last_seen_within_days` `integer` — Only include people last seen within this many days, as a rolling window.
+- `phone` `string` — Only include the person linked to this phone number.
+- `query` `string` — Search people by name, email, phone, or whop user ID (case-insensitive substring match).
+- `source` `string[]` — Only include people acquired from any of these sources — canonical paths (whop:<campaign>:<group>:<ad>, ext:<platform>:..., referrer:<domain>, direct, other), exact or with a trailing :* prefix. The same vocabulary the events / people metrics use.
+- `user_id` `string` — Only include the person linked to this whop user ID.
+
+</details>
+<details>
+<summary>plans (6)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/plans`.
+
+- `created_after` `string` — Only return plans created after this timestamp.
+- `created_before` `string` — Only return plans created before this timestamp.
+- `plan_types` `string[]` — Filter to only plans matching these billing types.
+- `product_ids` `string[]` — Filter to only plans belonging to these product identifiers.
+- `release_methods` `string[]` — Filter to only plans matching these release methods.
+- `visibilities` `string[]` — Filter to only plans matching these visibility states.
+
+</details>
+<details>
+<summary>products (2)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/products`.
+
+- `access_pass_types` `string[]` — Filter to only products matching these types.
+- `visibilities` `string[]` — Filter to only products matching these visibility states.
+
+</details>
+<details>
+<summary>promo_codes (5)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/promo_codes`.
+
+- `created_after` `string` — Only promo codes created after this ISO 8601 timestamp.
+- `created_before` `string` — Only promo codes created before this ISO 8601 timestamp.
+- `plan_ids` `string[]` — Only promo codes scoped to these plan IDs.
+- `product_ids` `string[]` — Only promo codes scoped to these product IDs.
+- `status` `string` — Promo-code status. `expired` groups inactive and archived codes. One of `active`, `inactive`, `archived`, `expired`.
+
+</details>
+<details>
+<summary>resolution_center_cases (6)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/resolution_center_cases`.
+
+- `created_after` `string` — Only cases created after this ISO 8601 timestamp.
+- `created_before` `string` — Only cases created before this ISO 8601 timestamp.
+- `outcome` `string[]` — Only closed cases that ended these ways. Repeat the parameter to pass several.
+- `reason` `string[]` — Only cases opened for these reasons. Repeat the parameter to pass several.
+- `status` `string[]` — Only cases in these statuses. Repeat the parameter to pass several — one paginated list covers all of them.
+- `user_id` `string` — Only cases opened by this customer — a `user_` tag, or `me` for the calling user. It narrows what you can already read, so `me` lists the cases you opened without the ones on accounts you are a team member of.
+
+</details>
+<details>
+<summary>shipments (4)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/shipments`.
+
+- `created_after` `string` — Return shipments created after this ISO 8601 timestamp.
+- `created_before` `string` — Return shipments created before this ISO 8601 timestamp.
+- `payment_id` `string[]` — Only shipments fulfilling these payments, each prefixed `pay_`. Repeat the parameter to pass several, up to 100 per request — one paginated list covers all of them.
+- `status` `string` — Filter to shipments with this delivery status. One of `unknown`, `pre_transit`, `in_transit`, `out_for_delivery`, `delivered`, `available_for_pickup`, `return_to_sender`, `failure`, `cancelled`, `error`.
+
+</details>
+<details>
+<summary>social_accounts (4)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/social_accounts`.
+
+- `platform` `string` — Only return social accounts for the platform that is specified. One of `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `discord`, `telegram`.
+- `scopes` `string[]` — Only return social accounts that have these scopes.
+- `user_id` `string` — The User that the social accounts are connected to. Provide either this or account_id.
+- `verified` `boolean` — Only return social accounts that are verified on the platform.
+
+</details>
+<details>
+<summary>team_members (5)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/team_members`.
+
+- `created_after` `string` — Only return members added after this ISO 8601 timestamp.
+- `created_before` `string` — Only return members added before this ISO 8601 timestamp.
+- `role` `string` — Only return members with this role. `custom` matches members on a dashboard-managed custom role. One of `owner`, `admin`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `custom`.
+- `status` `string` — Only return members with this status: `joined` (accepted members) or `pending` (pending invites). Both are returned by default. One of `joined`, `pending`.
+- `user_id` `string` — Only return the membership for this user ID, prefixed `user_`.
+
+</details>
+<details>
+<summary>transfers (4)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/transfers`.
+
+- `created_after` `string` — Only transfers created strictly after this ISO 8601 timestamp.
+- `created_before` `string` — Only transfers created strictly before this ISO 8601 timestamp.
+- `destination_id` `string` — Filter to transfers received by this account. Provide this or origin_id.
+- `origin_id` `string` — Filter to transfers sent from this account. Provide this or destination_id.
+
+</details>
+<details>
+<summary>webhooks (1)</summary>
+
+Mirrors the filtering query params of `GET /api/v1/webhooks`.
+
+- `app_id` `string` — Only return webhooks attached to this app. Omit to list the account's own webhooks.
+
+</details>
+</details> |
+| `--resource` | `string` | yes |  | The resource to export, e.g. `payouts`, `receipts`, or `members`. |
+| `--timezone` | `string` | no |  | IANA timezone for date columns, e.g. `America/New_York`. Defaults to `UTC`. |
+| `--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 exports get
+
+Retrieve Export
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | The export ID, prefixed `exprt_`. |
+
+---
+
+# whop exports list
+
+List Exports
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | The account to list exports for, prefixed `biz_`. Defaults to the credential's account. |
+| `--resource` | `string` | no |  | Only return exports of this resource. |
+| `--status` | `string` | no |  | Only return exports in this status. |
+| `--created_after` | `string` | no |  | Only return exports created at or after this ISO 8601 timestamp. |
+| `--created_before` | `string` | no |  | Only return exports created at or before this ISO 8601 timestamp. |
+| `--order` | `string` | no |  | The field to sort by. |
+| `--direction` | `string` | no |  | The sort direction. |

package/skills/whop-ledgers/SKILL.md

@@ -9,11 +9,43 @@ A Ledger Activity row is a single financial event on an account's ledger — a p
 
 Use Ledger Activity to build a statement or transaction feed for an account or user. Reconcile against your own records with `amount` (signed, in the currency's smallest precision units) and `posted_at`, and use `available_at` to know when inflows became withdrawable.
 
-## Commands
+# whop ledgers list
 
-| Command | Description |
-|---------|-------------|
-| `whop ledgers list` | List Financial Activity |
-| `whop ledgers report` | Get Financial Report |
+List Financial Activity
 
-Run `whop ledgers <command> --help` for options, or `whop ledgers <command> --schema` for full argument details.
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | The owning account ID (a biz_ identifier). Provide this or user_id. |
+| `--user_id` | `string` | no |  | The owning user ID (a user_ identifier). Provide this or account_id. |
+| `--include_owned_accounts` | `boolean` | no |  | When true, aggregates the authenticated user's personal ledger with the businesses they own (owner role with balance read) into one feed. Requires user_id to be the authenticated user; cannot be combined with account_id or the settlement-date filters. Each returned row includes the owning `account`. |
+| `--line_types` | `array` | no |  | Optional ledger line categories to include. Some categories (for example `onchain_deposit`, which covers inbound crypto deposits such as MoonPay onramps) are only returned when explicitly requested here. |
+| `--currency` | `string` | no |  | Optional currency code filter, for example `usd`. |
+| `--posted_after` | `string` | no |  | Only include rows posted after this ISO 8601 timestamp. |
+| `--posted_before` | `string` | no |  | Only include rows posted before this ISO 8601 timestamp. |
+| `--available_after` | `string` | no |  | Only include rows whose funds became withdrawable on or after this `YYYY-MM-DD` settlement date (UTC), distinct from posted_at. Requires currency. |
+| `--available_before` | `string` | no |  | Only include rows whose funds became withdrawable on or before this `YYYY-MM-DD` settlement date (UTC). Set equal to available_after for a single day. Requires currency. |
+| `--limit` | `number` | no | `20` | Maximum number of rows to return. |
+| `--cursor` | `string` | no |  | Cursor returned by the previous page. |
+
+---
+
+# whop ledgers report
+
+Get Financial Report
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | The owning account ID (a biz_ identifier), or `global` for a platform-wide report across all ledger accounts (requires internal admin access). |
+| `--report_type` | `string` | yes |  | The type of financial report to generate. |
+| `--currency` | `string` | no |  | Filter rows to this currency, for example `usd`. Defaults to `usd` unless `in_currency` is provided. |
+| `--in_currency` | `string` | no |  | Aggregate all activity into this display currency via FX conversion. |
+| `--from_date` | `string` | no |  | Start of the report window as an ISO 8601 timestamp (UTC). Required for platform-wide (global) reports. |
+| `--to_date` | `string` | no |  | End of the report window as an ISO 8601 timestamp (UTC). Required for platform-wide (global) reports. |
+| `--group_by` | `string` | no |  | Grouping granularity for report rows. |
+| `--timezone` | `string` | no |  | IANA timezone (for example `America/New_York`) used to bucket report periods and to interpret calendar-day boundaries for balance snapshots. Defaults to UTC. from_date/to_date remain exact instants regardless of this setting. |
+| `--cumulative` | `boolean` | no | `false` | Platform-wide (global) reports only: when true, return cumulative balances as of to_date (all history, no lower bound) instead of activity within the period. |
+| `--scope_account_id` | `string` | no |  | Platform-wide (global) reports only: narrow the report to ledger lines on the ledger account owned by this account ID (a biz_ identifier). Ignored unless account_id is `global`. |

package/skills/whop-media/SKILL.md

@@ -9,15 +9,36 @@ A Media Asset is an AI-generated image or video created from a prompt and billed
 
 Use the Media API to start a generation job and retrieve the asset while it processes or after it is ready.
 
-## Commands
+# whop media generate
 
-| Command | Description |
-|---------|-------------|
-| `whop media generate` | Generate Media Asset |
-| `whop media get` | Retrieve Media Asset |
+Generate Media Asset
 
-Run `whop media <command> --help` for options, or `whop media <command> --schema` for full argument details.
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Account ID, prefixed `biz_`. Defaults to the account the API key belongs to. |
+| `--duration_seconds` | `unknown` | no |  | Video length in seconds. Video only; defaults to 5. |
+| `--prompt` | `string` | yes |  | What to generate. Up to 2,000 characters. |
+| `--reference_media` | `array` | no |  | Optional reference image file IDs (`file_` prefixed), up to 4. For video, a single reference seeds the opening frame; multiple references guide subject and style instead. |
+| `--resolution` | `string` | no |  | Video resolution. Video only; defaults to `1080p`. `1080p` is not supported by Seedance 2.0 Fast or Mini; `4k` is only supported by Seedance 2.0. |
+| `--type` | `string` | yes |  | The kind of media to generate. |
+| `--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 media get
+
+Retrieve Media Asset
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Media asset ID, prefixed `media_`. |
 
 ## 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.
+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-members/SKILL.md

@@ -9,11 +9,56 @@ A Member is one buyer's relationship with an account — one record per customer
 
 Use the Members API to list an account's members with filtering by access level, status, join date, and name or username search, and to retrieve a single member. Member rows are created and maintained by the membership lifecycle; to grant or revoke access, work with memberships instead.
 
-## Commands
+# whop members get
 
-| Command | Description |
-|---------|-------------|
-| `whop members list` | List Members |
-| `whop members get` | Retrieve Member |
+Retrieve Member
 
-Run `whop members <command> --help` for options, or `whop members <command> --schema` for full argument details.
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Member ID (`mber_` tag). |
+
+---
+
+# whop members list
+
+List Members
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | The account to list members for (`biz_` tag). Defaults to the account the credential acts as. |
+| `--access_level` | `string` | no |  | Filter by what the member can reach on the account. |
+| `--status` | `string` | no |  | Filter by whether the member is still part of the account. |
+| `--query` | `string` | no |  | Search members by name or username. An exact email address also matches when the credential holds the member:email:read scope. |
+| `--created_after` | `string` | no |  | Only members who joined after this ISO 8601 timestamp. |
+| `--created_before` | `string` | no |  | Only members who joined before this ISO 8601 timestamp. |
+| `--order` | `string` | no |  | Sort field. |
+| `--direction` | `string` | no |  | Sort direction. |
+| `--first` | `number` | no | `20` | Number of members to return from the start of the window. |
+| `--after` | `string` | no |  | Cursor to paginate forwards from. |
+| `--last` | `number` | no |  | Number of members to return from the end of the window. |
+| `--before` | `string` | no |  | Cursor to paginate backwards from. |
+
+---
+
+# whop members logs
+
+List Member Logs
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Member ID (`mber_` tag). |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--first` | `number` | no | `20` | Number of log entries to return from the start of the window. |
+| `--after` | `string` | no |  | Cursor to paginate forwards from. |
+| `--last` | `number` | no |  | Number of log entries to return from the end of the window. |
+| `--before` | `string` | no |  | Cursor to paginate backwards from. |

package/skills/whop-memberships/SKILL.md

@@ -9,16 +9,140 @@ A Membership is a customer's purchase of a plan: the subscription or one-time gr
 
 Use the Memberships API to list an account's memberships or the caller's own, retrieve one by ID or license key, and manage the lifecycle: cancel immediately or at period end, reverse a scheduled period-end cancellation, pause and resume payment collection, extend with free days, and update metadata.
 
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `whop memberships list` | List Memberships |
-| `whop memberships get` | Retrieve Membership |
-| `whop memberships update` | Update Membership |
-| `whop memberships cancel` | Cancel Membership |
-| `whop memberships extend` | Extend Membership |
-| `whop memberships pause` | Pause Membership |
-| `whop memberships resume` | Resume Membership |
-
-Run `whop memberships <command> --help` for options, or `whop memberships <command> --schema` for full argument details.
+# whop memberships cancel
+
+Cancel Membership
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Membership ID (`mem_` tag). |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--reason` | `string` | no |  | Free-form note recording why the membership was canceled. |
+| `--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 memberships extend
+
+Extend Membership
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Membership ID (`mem_` tag). |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--days` | `number` | yes |  | Number of free days to add (1-1095). |
+| `--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 memberships get
+
+Retrieve Membership
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Membership ID (`mem_` tag), or a software license key. |
+
+---
+
+# whop memberships list
+
+List Memberships
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--account_id` | `string` | no |  | Narrow to one account (`biz_` tag). With read access to the account this lists all of its memberships; without, only the caller's own memberships in it. |
+| `--user_id` | `string` | no |  | Narrow to one user's memberships (`user_` tag, or `me` for the caller). A user outside the caller's visible set returns an empty list. |
+| `--status` | `string` | no |  | Filter by billing state. `canceling` matches active memberships set to cancel at period end; `paused` matches memberships with payment collection paused. |
+| `--product_id` | `string` | no |  | Filter to memberships of this product (`prod_` tag). Repeat as product_ids[] for several. |
+| `--plan_id` | `string` | no |  | Filter to memberships of this plan (`plan_` tag). Repeat as plan_ids[] for several. |
+| `--created_after` | `string` | no |  | Only memberships created after this ISO 8601 timestamp. |
+| `--created_before` | `string` | no |  | Only memberships created before this ISO 8601 timestamp. |
+| `--order` | `string` | no |  | Sort field. |
+| `--direction` | `string` | no |  | Sort direction. |
+| `--first` | `number` | no | `20` | Number of memberships to return from the start of the window. |
+| `--after` | `string` | no |  | Cursor to paginate forwards from. |
+| `--last` | `number` | no |  | Number of memberships to return from the end of the window. |
+| `--before` | `string` | no |  | Cursor to paginate backwards from. |
+
+---
+
+# whop memberships pause
+
+Pause Membership
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Membership ID (`mem_` tag). |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--until` | `string` | no |  | ISO 8601 time to automatically resume payment collection. Must be in the future; only supported for memberships billed by Whop. |
+| `--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 memberships resume
+
+Resume Membership
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Membership ID (`mem_` tag). |
+
+## 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 memberships update
+
+Update Membership
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `id` | `string` | yes | Membership ID (`mem_` tag), or a software license key. |
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--cancel_at_period_end` | `boolean` | no |  | `true` cancels at the end of the current billing period (the customer keeps access until then); `false` reverses a pending cancellation. |
+| `--metadata` | `object` | no |  | Key-value pairs to merge into the membership's metadata. Pass an empty object to clear it. |
+
+> Confirm with the user before executing this destructive command.