motion-cart 0.1.0 → 0.1.4

package/README.md

@@ -15,8 +15,25 @@ target, and a Claude agent edits your real source while the preview hot-reloads.
 
 - A project that is a **clean git repo** (edits land on an isolated `motion-cart/session-*` branch).
 - An **already-running local dev server** for that project; pass its URL via `--dev-url` (loopback only).
-- The agent uses your existing **Claude Code login** (no separate API key needed). `--token`
-  (or `MOTION_PLUS_TOKEN`) enables the live Motion AI Kit MCP.
+## Model provider (auth)
+
+By default the agent uses your existing **Claude Code login** (no key needed). You can instead
+point it at **any Anthropic-compatible gateway** — including **iO Bonzai** — with your own key:
+
+```bash
+npx motion-cart --target . --dev-url http://localhost:5173 \
+  --base-url https://api-v2.bonzai.iodigital.com \
+  --api-key  <your-bonzai-key> \
+  --model    claude-4-5-sonnet
+```
+
+`--base-url`/`--api-key`/`--model` map to `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / model for
+the agent (env equivalents: `MOTION_CART_BASE_URL` / `MOTION_CART_API_KEY` / `MOTION_CART_MODEL`).
+The gateway must expose the Anthropic **Messages** route (`<base-url>/v1/messages`) — LiteLLM-based
+gateways like Bonzai do; a purely OpenAI-shaped endpoint won't work.
+
+> Auth gotcha: an invalid `ANTHROPIC_API_KEY` in your shell **overrides** your Claude login and
+> causes `401 Invalid bearer token`. `unset` it, or pass `--api-key`/`--base-url` explicitly.
 
 ## Flags
 
@@ -24,6 +41,9 @@ target, and a Claude agent edits your real source while the preview hot-reloads.
 |---|---|---|
 | `--dev-url` | (required) | URL of your running local dev server |
 | `--target` | cwd | project directory the agent edits |
+| `--base-url` | `$MOTION_CART_BASE_URL` | custom Anthropic-compatible gateway (e.g. iO Bonzai) |
+| `--api-key` | `$MOTION_CART_API_KEY` | API key for that gateway |
+| `--model` | `$MOTION_CART_MODEL` | model id (e.g. `claude-4-5-sonnet`) |
 | `--port` | 7100 | control panel port |
 | `--proxy-port` | 7101 | injecting proxy port |
 | `--token` | `$MOTION_PLUS_TOKEN` | Motion+ token to enable the Motion MCP |