@promptai.credit/cli 0.4.1 → 0.4.3

package/README.md

@@ -6,17 +6,36 @@ Cursor Agents Window are supported today; Codex CLI is next.
 
 ## How it works
 
-1. `promptai install claude` merges two hooks into `~/.claude/settings.json`:
+1. `promptai install claude` merges two hooks into `~/.claude/settings.json` and
+   installs the Claude Mods plugin into `~/.claude/skills/promptai/`:
    - **UserPromptSubmit**: baselines the session's transcript watermark and (if opted
      in, at most every 90s, never headless) opens the hosted rewarded-ad page
-     (`/watch`) in your browser. The ad plays while your agent works.
+     (`/watch`) in your browser — **unless** the Mods plugin is live (heartbeat in
+     `~/.promptai/native-plugin.json`), in which case the native AbovePrompt card
+     shows the ad instead.
    - **Stop** (async): reads the session transcript JSONL since the watermark, prices
      the turn with the shared model price table, and redeems one banked
      server-verified ad session against it via the API.
-2. The `/watch` page creates the ad session server-side on load, so SSV wall-clock
-   timing is enforced by the server; the browser countdown is cosmetic.
+   - **Mods plugin** (`product/claude-plugin`): on `prompt.submit` fetches an ad
+     session and renders a compact sponsored card via `ui.render` / `AbovePrompt`.
+2. The `/watch` page (and the native card) create the ad session server-side, so SSV
+   wall-clock timing is enforced by the server; countdowns are cosmetic.
 3. `promptai claim` pays out your verified balance as USDC on Base.
 
+### Claude Mods (native card)
+
+Native AbovePrompt ads need Claude Code function hooks (early access until GA).
+`promptai install claude` sets `env.CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1` in
+`~/.claude/settings.json` (an explicit value you already set is left alone, and
+`promptai uninstall claude` removes only what it added). This also enables any other
+function-hook plugins you use. Where Mods are unavailable, command hooks open `/watch`
+in the browser.
+Dev-load the plugin without installing:
+
+```bash
+CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude --plugin-dir product/claude-plugin
+```
+
 ## Cursor Agents Window (Glass)
 
 The Agents Window doesn't run VS Code extensions, so the promptai extension can't
@@ -45,7 +64,7 @@ State lives in `~/.promptai/` (`config.json`, `state.json`, `cli.log`).
 
 ```bash
 npm install -g @promptai.credit/cli
-promptai install claude      # Claude Code hooks
+promptai install claude      # Claude Code hooks + Mods plugin
 promptai install cursor      # Cursor Agents Window / classic IDE hooks
 ```
 
@@ -82,4 +101,4 @@ Developing from the repo instead: `pnpm --filter @promptai.credit/cli build`, th
 - Headless environments (CI, ssh without a display) never get browser tabs and
   simply skip crediting.
 - Uninstall with `promptai uninstall claude`; other hooks in your settings are
-  preserved.
+  preserved, and the Mods plugin under `~/.claude/skills/promptai/` is removed.

package/claude-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "promptai",
+  "version": "0.1.0",
+  "description": "Opt-in rewarded ads above the Claude Code prompt. Watch a short sponsored card while the agent works; verified watches fund prompt credits via promptai.credit.",
+  "author": {
+    "name": "PromptAI",
+    "url": "https://promptai.credit"
+  },
+  "homepage": "https://promptai.credit",
+  "keywords": ["ads", "credits", "promptai", "rewarded"]
+}

package/claude-plugin/README.md

@@ -0,0 +1,37 @@
+# PromptAI Claude Code plugin
+
+Native rewarded-ad card for Claude Code via **Claude Mods** (function hooks).
+
+While the agent works, a compact sponsored row renders above the prompt
+(`AbovePrompt`). After the server-verified watch window, the credit is banked
+the same way as the browser `/watch` path. Transcript pricing and redeem still
+run through the `promptai` CLI `Stop` command hook.
+
+## Requirements
+
+- Claude Code with function hooks enabled (early access). `promptai install claude`
+  sets `env.CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1` in `~/.claude/settings.json`; to enable
+  it by hand, use `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude`.
+
+- `promptai install claude` (wires command hooks, enables the flag, copies this plugin)
+
+## Dev load (without install)
+
+```bash
+CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude --plugin-dir /path/to/product/claude-plugin
+```
+
+## Notes
+
+- If Mods are off or the module fails to load, the CLI falls back to opening
+  `/watch` in the browser (fail open).
+- The plugin writes `~/.promptai/native-plugin.json` on `session.start` so the
+  CLI can skip the browser tab while the native card is live.
+- The brand logo (PNG, favicon or SVG) is drawn as half-block cells, so it works in any
+  terminal. It is fetched with `curl` and converted with `sips` (macOS) or ImageMagick;
+  SVGs need `qlmanage` (macOS) or `rsvg-convert`. If any step is missing the card simply
+  draws without a logo. Results are cached under `~/.promptai/logos/`.
+- Jev ticker: the plugin polls `GET /stocks/ticker` (Jev's current top picks, with
+  Robinhood Chain prices and 24h change from DefiLlama). The picks show on the ad
+  card, the credited slices show on the verified strip, and a compact ticker rides the
+  prompt hint while the agent works. If the server has Jev off, the ticker stays hidden.