@whop/cli 0.10.1 → 0.11.0

package/README.md

@@ -58,20 +58,35 @@ Agent OAuth recipe:
 
 The flow redirects to `localhost:13337`, so the browser must run on the same host as the CLI (or forward that port to the CLI host). Fully remote browser authorization will require a future device login flow.
 
-## Deploy an app
+## Build and deploy apps
+
+Fully-hosted web apps (`*.whop.app`) follow a git-shaped lifecycle — two on-ramps, one loop:
 
 ```bash
-whop apps deploy
+# Start a NEW app: registers it, scaffolds the latest TanStack Start
+# template (or --template app_xxx to clone another app's published source),
+# wires it for Whop hosting, installs, and git-inits
+whop apps init
+
+# …or get an EXISTING app's deployed source onto this machine: downloads the
+# production build's source archive (--build abld_xxx for any specific build)
+# and three-way merges it with whatever is here via git
+whop apps pull --app app_xxxxxxxx
+
+# The loop
+whop apps dev                     # local dev server, credentials auto-injected
+whop apps deploy                  # build → typecheck → upload → promote to production
 ```
 
-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`.
+`deploy` ships the linked project; `--preview` uploads without promoting, and `whop apps builds promote <build_id>` ships it later — promoting an older build is also how you roll back. `pull` and `deploy` share a per-app snapshot ref (`refs/whop/remote/<app_id>`), so pulls always merge against the last state this machine saw: local edits are autostashed around the merge and conflicts surface as normal git conflict markers.
+
+Everything else is plain REST: `whop apps list|create|get|update`, `whop apps builds list|get|promote`, and `whop apps secrets list|set|unset`.
 
 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"
+whop apps logs app_xxxxxxxx --level error
+whop apps logs app_xxxxxxxx --query "checkout"
 ```
 
 ## Run ads