waitspin 0.1.9 → 0.1.11

package/README.md

@@ -26,11 +26,13 @@ waitspin bid create --line "Your ad" --url https://example.com --price-per-block
 waitspin bid checkout CAMPAIGN_ID
 npx --yes waitspin init --email you@example.com --key-profile publisher-extension
 
-# First-class VS Code user path
+# First-class VS Code-compatible user paths
 code --install-extension waitspin.waitspin-vscode
-# Then run "WaitSpin: Connect and earn" inside VS Code.
+cursor --install-extension waitspin.waitspin-vscode
+devin-desktop --install-extension waitspin.waitspin-vscode
+# Then run "WaitSpin: Connect and earn" inside the matching editor.
 
-# Advanced agent install for every detected supported target
+# Advanced agent install for every detected all-install target
 waitspin install --all --dry-run --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 waitspin install --all --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 waitspin status --all
@@ -62,6 +64,10 @@ waitspin opencode status
 # Or install for Grok Code CLI footer
 waitspin grok install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 waitspin grok status
+
+# Or install for Qoder CLI UserPromptSubmit/Stop hooks
+waitspin qoder install --api-key PASTE_PUBLISHER_EXTENSION_KEY
+waitspin qoder status
 ```
 
 ## Commands
@@ -76,12 +82,14 @@ waitspin grok status
 - `waitspin wallet ledger` — user delivery ledger
 - `waitspin wallet payout --dry-run` — payout eligibility preview
 - `code --install-extension waitspin.waitspin-vscode` — install the public VS Code Marketplace extension
-- `WaitSpin: Connect and earn` — connect the VS Code extension from inside the editor
+- `cursor --install-extension waitspin.waitspin-vscode` — install the same VS Code-compatible extension into Cursor Editor Mode
+- `devin-desktop --install-extension waitspin.waitspin-vscode` — install the same extension into Devin Desktop from Open VSX when the desktop CLI is on PATH
+- `WaitSpin: Connect and earn` — connect the VS Code-compatible extension from inside the matching editor
 - `waitspin extension install --target vscode --api-key PASTE_PUBLISHER_EXTENSION_KEY` — advanced CLI fallback for VS Code extension setup
 - `waitspin extension status --target vscode` — inspect managed VS Code extension lifecycle state
 - `waitspin extension uninstall --target vscode` — remove the managed VS Code extension runtime and local state
 - `waitspin install --all --dry-run` — preview detected user surfaces without file changes
-- `waitspin install --all` — install every detected supported user surface
+- `waitspin install --all` — install every detected all-install surface: VS Code plus CLI-managed targets
 - `waitspin status --all` — aggregate lifecycle status for every user surface
 - `waitspin claude-code install --compose-existing` — install the Claude Code statusline command
 - `waitspin claude-code status` — inspect managed Claude Code runtime state
@@ -101,26 +109,35 @@ waitspin grok status
 - `waitspin grok install` — install the Grok Code CLI footer surface
 - `waitspin grok status` — inspect managed Grok Code CLI runtime state
 - `waitspin grok uninstall` — restore Grok Code CLI and remove managed state
+- `waitspin qoder install` — install the Qoder CLI UserPromptSubmit/Stop hooks
+- `waitspin qoder status` — inspect managed Qoder CLI runtime state
+- `waitspin qoder uninstall` — remove the managed Qoder hook and local state
 
 API base: `https://api.waitspin.com`
 
-The public package installs seven verified user earning surfaces: the VS Code
-Activity Bar/status-bar extension, the Claude Code statusline command, the
-Antigravity CLI statusline command, the GitHub Copilot CLI statusline command,
-the MiMo Code shell hook, the OpenCode TUI plugin slot, and the Grok Code CLI
-footer. Claude Code, Antigravity CLI, and GitHub Copilot CLI support use
+The public package manages the public target set: the status-bar-fallback
+extension path for VS Code, Cursor Editor Mode, and Devin Desktop through Open
+VSX, the Claude Code statusline command, the Antigravity CLI statusline command,
+the GitHub Copilot CLI statusline command, the MiMo Code shell hook, the
+OpenCode TUI plugin slot, the Grok Code CLI footer, and the Qoder CLI
+UserPromptSubmit/Stop hooks. Claude Code,
+Antigravity CLI, and GitHub Copilot CLI support use
 first-class `statusLine.command` paths and do not patch native binaries. MiMo
 Code uses a bash hook that polls the API for sponsored messages. OpenCode uses
 its TUI `app_bottom` plugin slot. Grok Code CLI uses a managed text-asset
 footer patch with hash-backed backup/restore and does not patch native
-binaries.
+binaries. Qoder CLI uses the official `UserPromptSubmit` hook with
+`statusMessage`/`systemMessage` plus the official `Stop` hook for the later
+visibility callback; it does not patch native binaries or npm
+package files.
 
 `waitspin install --all` is an advanced agent command for installing every
-detected supported target. It keeps explicit target commands as the canonical
-debug path, supports `--dry-run`, skips unsupported local tools in
-`skipped_not_detected`, reports recoverable config conflicts in
-`skipped_conflict`, and reports unexpected installer failures in
-`failed_rollback`.
+detected all-install target: VS Code plus CLI-managed targets. Cursor Editor
+Mode and Devin Desktop stay on the explicit editor-extension install paths
+above. Install-all keeps explicit target commands as the canonical debug path,
+supports `--dry-run`, skips unsupported local tools in `skipped_not_detected`,
+reports recoverable config conflicts in `skipped_conflict`, and reports
+unexpected installer failures in `failed_rollback`.
 
 Payout execution is guarded server-side. Public launch proof uses Stripe test
 mode with `waitspin wallet payout --confirm-test-transfer`; live transfers stay
@@ -138,7 +155,9 @@ user install polling/events:
 ```bash
 npx waitspin init --email you@example.com --key-profile publisher-extension
 code --install-extension waitspin.waitspin-vscode
-# Then run "WaitSpin: Connect and earn" inside VS Code.
+cursor --install-extension waitspin.waitspin-vscode
+devin-desktop --install-extension waitspin.waitspin-vscode
+# Then run "WaitSpin: Connect and earn" inside the matching editor.
 npx waitspin install --all --dry-run --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 npx waitspin install --all --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-existing
 npx waitspin status --all
@@ -149,17 +168,20 @@ npx waitspin copilot install --api-key PASTE_PUBLISHER_EXTENSION_KEY --compose-e
 npx waitspin mimocode install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 npx waitspin opencode install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 npx waitspin grok install --api-key PASTE_PUBLISHER_EXTENSION_KEY
+npx waitspin qoder install --api-key PASTE_PUBLISHER_EXTENSION_KEY
 ```
 
 - `WAITSPIN_API_KEY` — temporary extension API key for CLI fallback flows
 - `WAITSPIN_INSTALL_ID` — from `waitspin extension install` or `waitspin claude-code install`
 
 The VS Code Marketplace extension should normally be connected through
-`WaitSpin: Connect and earn`, which stores the extension key in VS Code
-SecretStorage and stores the install ID in user-scoped extension state. The
-legacy `waitspin.apiKey` User setting is still migrated into SecretStorage for
-fallback/rotation, but normal user operation does not require copying
-install IDs or broad control keys into workspace settings.
+`WaitSpin: Connect and earn`, which stores the extension key in VS
+Code-compatible SecretStorage and stores the install ID in user-scoped extension
+state. Cursor uses the same extension ID, and Devin Desktop uses the Open VSX
+listing at `https://open-vsx.org/extension/waitspin/waitspin-vscode`. The legacy
+`waitspin.apiKey` User setting is still migrated into SecretStorage for
+fallback/rotation, but normal user operation does not require copying install
+IDs or broad control keys into workspace settings.
 
 The Claude Code installer writes a managed statusline runtime/state under
 `~/.waitspin` and updates `~/.claude/settings.json` with a safe
@@ -184,7 +206,16 @@ The Grok Code CLI installer writes a managed runtime/state under `~/.waitspin`
 and patches the verified OpenTUI footer text asset with a hash-backed backup so
 uninstall can restore the original file.
 
-Cline VS Code extension installs are covered by the VS Code Activity Bar/status-bar extension target.
+The Qoder CLI installer writes a managed hook runtime/state/cache under
+`~/.waitspin` and adds managed `UserPromptSubmit` and `Stop` hook entries to
+`~/.qoder/settings.json`. The hook returns dynamic sponsored copy through
+Qoder's `systemMessage` response only after fetching WaitSpin inventory; the
+static hook `statusMessage` is a generic sponsor check and is not billable by
+itself. A billable Qoder impression also requires a later official Qoder hook
+callback after the minimum visible interval.
+
+Cline VS Code extension installs, Cursor Editor Mode, and Devin Desktop are
+covered by the VS Code-compatible Activity Bar/status-bar extension target.
 Standalone Cline CLI is not a public install target until Cline exposes an
 official statusline/plugin surface.
 
@@ -202,4 +233,5 @@ npx --yes waitspin@latest opencode status
 npx --yes waitspin@latest grok status
 npx --yes waitspin@latest antigravity status
 npx --yes waitspin@latest copilot status
+npx --yes waitspin@latest qoder status
 ```