@blockrun/clawrouter 0.12.85 → 0.12.87

package/README.md

@@ -74,17 +74,94 @@ This is the stack that lets agents operate autonomously: **x402 + USDC + local r
 
 ## Quick Start
 
+### Option A — OpenClaw Agent
+
+[OpenClaw](https://openclaw.ai) is an AI coding agent. If you're using it, ClawRouter installs as a plugin:
+
 ```bash
-# 1. Install with smart routing enabled
 curl -fsSL https://blockrun.ai/ClawRouter-update | bash
 openclaw gateway restart
-
-# 2. Fund your wallet with USDC on Base or Solana (address printed on install)
-# $5 is enough for thousands of requests
 ```
 
 Done. Smart routing (`blockrun/auto`) is now your default model.
 
+### Option B — Standalone (continue.dev, Cursor, VS Code, any OpenAI-compatible client)
+
+> **Using Claude Code?** Check out [BRCC](https://github.com/BlockRunAI/brcc) — it's purpose-built for Claude Code with the same smart routing and x402 payments.
+
+No OpenClaw required. ClawRouter runs as a local proxy on port 8402.
+
+**1. Start the proxy**
+
+```bash
+npx @blockrun/clawrouter
+```
+
+**2. Fund your wallet**
+Your wallet address is printed on first run. Send a few USDC on Base or Solana — $5 covers thousands of requests.
+
+**3. Point your client at `http://localhost:8402`**
+
+<details>
+<summary><strong>continue.dev</strong> — <code>~/.continue/config.yaml</code></summary>
+
+> **Important:** `apiBase` must end with `/v1/` (including the trailing slash). Without it, continue.dev constructs the URL as `/chat/completions` instead of `/v1/chat/completions`, and the proxy returns 404.
+
+```yaml
+models:
+  - name: ClawRouter Auto
+    provider: openai
+    model: blockrun/auto
+    apiBase: http://localhost:8402/v1/
+    apiKey: x402
+    roles:
+      - chat
+      - edit
+      - apply
+```
+
+To pin a specific model, replace `blockrun/auto` with any model from [blockrun.ai/models](https://blockrun.ai/models), e.g. `anthropic/claude-opus-4.6`, `xai/grok-4-0709`.
+
+Both `provider: openai` and `provider: clawrouter` work — just make sure `apiBase` ends with `/v1/`.
+
+<details>
+<summary>Legacy JSON format (<code>~/.continue/config.json</code>)</summary>
+
+```json
+{
+  "models": [
+    {
+      "title": "ClawRouter Auto",
+      "provider": "openai",
+      "model": "blockrun/auto",
+      "apiBase": "http://localhost:8402/v1/",
+      "apiKey": "x402"
+    }
+  ]
+}
+```
+
+</details>
+</details>
+
+<details>
+<summary><strong>Cursor</strong> — Settings → Models → OpenAI-compatible</summary>
+
+Set base URL to `http://localhost:8402`, API key to `x402`, model to `blockrun/auto`.
+
+</details>
+
+<details>
+<summary><strong>Any OpenAI SDK</strong></summary>
+
+```python
+from openai import OpenAI
+client = OpenAI(base_url="http://localhost:8402", api_key="x402")
+response = client.chat.completions.create(model="blockrun/auto", messages=[...])
+```
+
+</details>
+
 ---
 
 ## Routing Profiles
@@ -440,14 +517,14 @@ Run Claude Code with 50+ models, no rate limits, no Anthropic account, no phone
 
 ### Blog
 
-| Article | Topic |
-| ------- | ----- |
-| [11 Free AI Models, Zero Cost](docs/11-free-ai-models-zero-cost-blockrun.md) | How BlockRun gives developers top-tier LLMs for nothing |
-| [ClawRouter Cuts LLM API Costs 500×](docs/clawrouter-cuts-llm-api-costs-500x.md) | Deep dive into cost savings |
-| [ClawRouter vs OpenRouter](docs/clawrouter-vs-openrouter-llm-routing-comparison.md) | Head-to-head comparison |
-| [Smart LLM Router: 14-Dimension Classifier](docs/smart-llm-router-14-dimension-classifier.md) | How the routing engine works |
-| [LLM Router Benchmark: 46 Models, Sub-1ms](docs/llm-router-benchmark-46-models-sub-1ms-routing.md) | Performance benchmarks |
-| [Anthropic Cost Savings](docs/anthropic-cost-savings.md) | Reducing Claude API spend |
+| Article                                                                                            | Topic                                                   |
+| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
+| [11 Free AI Models, Zero Cost](docs/11-free-ai-models-zero-cost-blockrun.md)                       | How BlockRun gives developers top-tier LLMs for nothing |
+| [ClawRouter Cuts LLM API Costs 500×](docs/clawrouter-cuts-llm-api-costs-500x.md)                   | Deep dive into cost savings                             |
+| [ClawRouter vs OpenRouter](docs/clawrouter-vs-openrouter-llm-routing-comparison.md)                | Head-to-head comparison                                 |
+| [Smart LLM Router: 14-Dimension Classifier](docs/smart-llm-router-14-dimension-classifier.md)      | How the routing engine works                            |
+| [LLM Router Benchmark: 46 Models, Sub-1ms](docs/llm-router-benchmark-46-models-sub-1ms-routing.md) | Performance benchmarks                                  |
+| [Anthropic Cost Savings](docs/anthropic-cost-savings.md)                                           | Reducing Claude API spend                               |
 
 ---
 
@@ -471,7 +548,7 @@ Both are open source and run locally. But ClawRouter adds smart routing (automat
 
 ### What agents does ClawRouter work with?
 
-ClawRouter integrates with OpenClaw (Claude Code), ElizaOS, and any agent that makes OpenAI-compatible API calls. It runs as a local proxy on port 8402.
+ClawRouter works with any tool that makes OpenAI-compatible API calls — point it at `http://localhost:8402`. This includes continue.dev, Cursor, VS Code extensions, ElizaOS, and custom agents. It also integrates as a plugin with [OpenClaw](https://openclaw.ai) (an AI coding agent), which enables additional features like slash commands and usage reports.
 
 ### Is ClawRouter free?