@pretense/cli 0.6.15 → 0.6.17

package/README.md

@@ -40,7 +40,7 @@ pretending.
      docs-exec:skip `pretense run gemini "summarise the changes"` — starts a proxy and a third-party tool that would outlive the suite
      docs-exec:skip "pretense run --provider openai mytool" — starts a proxy and a third-party tool that would outlive the suite
      docs-exec:skip "curl -s http://localhost:9339/health" — needs the proxy from the preceding line, which cannot be started here
-     docs-exec:skip "claude" — third-party CLI that is not a dependency of this repo
+     docs-exec:skip "ANTHROPIC_BASE_URL=http://localhost:9339 claude" — runs the third-party claude CLI (not a dependency of this repo) against a proxy that is not started here
      docs-exec:skip `curl -fsSLO "${BASE}/SHA256SUMS"` — network fetch from the release host
      docs-exec:skip `curl -fsSLO "${BASE}/SHA256SUMS.cosign.bundle"` — network fetch from the release host
      docs-exec:skip `curl -fsSLO "${BASE}/${TARGET}"` — network fetch of a large release binary
@@ -269,8 +269,17 @@ not used, are in [docs/verifying-releases.md](../docs/verifying-releases.md).
 
 ## The proxy
 
-`pretense start` runs a local HTTP proxy that applies the same mutation engine to
-LLM API traffic.
+The one-command way to route an AI tool through the mutating proxy is
+`pretense run <tool>` — it starts a proxy on a free port, sets the right
+base-URL env var, runs your tool, and stops the proxy when the tool exits. No
+manual export, no second terminal:
+
+```bash
+pretense run claude "explain this repo"
+```
+
+If you would rather run the proxy yourself, `pretense start` runs a local HTTP
+proxy that applies the same mutation engine to LLM API traffic:
 
 ```bash
 pretense start              # listens on port 9339
@@ -278,13 +287,19 @@ pretense start --port 9500  # any other port
 curl -s http://localhost:9339/health
 ```
 
-Then point your tool at it:
+Then point your tool at it **in the same terminal**, as a single command line —
+the base-URL assignment and the tool on one line:
 
 ```bash
-export ANTHROPIC_BASE_URL=http://localhost:9339
-claude
+ANTHROPIC_BASE_URL=http://localhost:9339 claude
 ```
 
+> ⚠ Set the base URL in the **same** terminal (same command) as your AI tool. A
+> new terminal does not inherit it and is **not** protected. `export
+> ANTHROPIC_BASE_URL=…` in one terminal and `claude` in another is the #1 way to
+> think you are protected when you are not. The simplest fix is `pretense run`,
+> which never asks you to export anything.
+
 `OPENAI_BASE_URL` works the same way, as does any client that accepts a base URL.
 
 ## Zero-export proxy runner

package/dist/{chunk-AULCU5QN.js → chunk-EFDPBFXJ.js}

@@ -17,7 +17,7 @@ function versionFromPackageJson() {
     return void 0;
   }
 }
-var PRETENSE_VERSION = (true ? "0.6.15" : void 0) ?? versionFromPackageJson() ?? "0.0.0-unknown";
+var PRETENSE_VERSION = (true ? "0.6.17" : void 0) ?? versionFromPackageJson() ?? "0.0.0-unknown";
 
 export {
   PRETENSE_VERSION