@whop/cli 0.6.0 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # Whop CLI
 
-`whop` — sell on Whop from your terminal. Create products, set pricing, and get a shareable checkout link without leaving your shell.
+`whop` — build and manage your Whop business from the terminal. Deploy apps, manage products and pricing, run ads, move money, and automate workflows from one agent-friendly CLI.
 
 ## Installation
 
@@ -23,7 +23,7 @@ Prebuilt binaries cover macOS and Linux ([releases](https://github.com/whopio/wh
 whop
 ```
 
-That's it — it signs you in and walks you to a shareable checkout link.
+That's it — it signs you in, lets you choose or create the business the CLI should use, and points you to the available workflows. Run `whop quickstart` later to change the selected business.
 
 ## Usage
 
@@ -36,6 +36,8 @@ whop stats list              # your numbers
 
 Every command takes `--format json` for structured output.
 
+In a terminal, commands that are missing required inputs ask for them interactively instead of failing — run `whop swaps quote` with no flags and it prompts for the amount and tokens. Agents and scripts (non-TTY) get a structured validation error instead.
+
 ## Deploy an app
 
 ```bash
@@ -44,6 +46,30 @@ whop apps deploy
 
 The one-stop deploy for fully-hosted web apps (`*.whop.app`): it verifies the current directory is a Whop-ready Vite app — offering to scaffold a new one or link an existing Whop app if not — then builds, typechecks, uploads, and promotes the build to production. Use `--skip_promote` to upload a preview build, and `whop apps builds promote <build_id>` to ship it later. Everything else is plain REST: `whop apps list|create|get|update` and `whop apps builds list|get|create|promote`.
 
+After a deploy, read your app's server logs — every `console.log`, uncaught exception, and failed request, kept for 7 days:
+
+```bash
+whop apps logs                    # recent logs for the linked app
+whop apps logs --level error --since 1h
+whop apps logs --query "checkout"
+```
+
+## Run ads
+
+Generate a creative, then create the campaign, ad group, and ad in one command — structured flags take JSON strings:
+
+```bash
+whop media generate --type image --prompt "A running club at sunrise" --wait
+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_id> --status active   # launch when ready
+```
+
+The installed `whop-ads` skill (`whop skills add`) carries the full playbook — billing setup, field rules, and monitoring.
+
 ## For AI agents
 
 The CLI is self-describing — agents can discover and drive every command: