clavue 8.8.92 → 8.8.93

package/README.md

@@ -1,4 +1,4 @@
-# Clavue v8.8.92
+# Clavue v8.8.93
 
 ![Clavue cover](https://unpkg.com/clavue/image.png)
 
@@ -48,46 +48,37 @@ Requirements:
 - Node.js 18 or newer
 - macOS or Linux shell environment
 
-Install globally from npm:
-
-```bash
-npm install -g clavue
-```
-
-Run it once with `npx` if you do not want a global install:
+Run once with `npx` when you do not want a global install:
 
 ```bash
 npx -y clavue
 ```
 
-This installs the `clavue` command:
+Run a specific version with `npx`:
 
 ```bash
-clavue
+npx -y clavue@8.8.93 --version
+npx -y clavue@8.8.93
 ```
 
-Then run the built-in installer once to configure the native launcher:
+Install globally from npm when you want the `clavue` command to stay available:
 
 ```bash
+npm install -g clavue
 clavue install --force
-```
-
-After that, you can launch with:
-
-```bash
 clavue
 ```
 
-One-line install:
+One-line global install:
 
 ```bash
 curl -fsSL https://unpkg.com/clavue/install.sh | bash
 ```
 
-Install a specific version:
+Install a specific version globally:
 
 ```bash
-curl -fsSL https://unpkg.com/clavue@8.8.92/install.sh | bash -s -- 8.8.92
+curl -fsSL https://unpkg.com/clavue@8.8.93/install.sh | bash -s -- 8.8.93
 ```
 
 ## Quick Start: Custom API
@@ -122,6 +113,16 @@ clavue provider validate
 
 Use `clavue auth login` only if you want the official Anthropic login path. Custom API users do not need official login.
 
+## First Useful Session
+
+Start Clavue from a repository and ask for one reviewable unit of work:
+
+```text
+Inspect the failing test around provider routing, make the smallest source fix, run the targeted test, then run the relevant verification command before reporting back.
+```
+
+Clavue should inspect files directly, edit the source, run commands such as `node --test tests/<file>.test.mjs`, and report what was verified.
+
 ## First-Run Setup Modes
 
 On first launch, Clavue should make the setup choice obvious:
@@ -166,7 +167,8 @@ Version check:
 ```bash
 clavue --version
 npx -y clavue --version
-# available after running: clavue install --force
+npx -y clavue@8.8.93 --version
+# available after a global install and launcher setup
 clavue --version
 ```
 
@@ -259,7 +261,7 @@ Companion commands are still available and can either follow the current app pro
 
 - clavue can import compatible profiles from `~/.ccjk/config.toml` or `~/.ufomiao/zcf/config.toml`.
 - Changing the active clavue provider profile writes the current selection back to those compatible config files.
-- Proxy GPT routes stay on the Anthropic-compatible `/v1/messages` path by default. Only set `MYCLAUDE_API_DIALECT=openai_responses` when you explicitly want the Responses adapter for that gateway.
+- Proxy GPT routes stay on the Anthropic-compatible `/v1/messages` path by default. Set `CLAVUE_API_DIALECT=openai_responses` only when you explicitly want the Responses adapter for that gateway; `MYCLAUDE_API_DIALECT` remains a legacy-compatible alias.
 - Recommended saved profile pattern: `gpt54-main` for a validated `gpt-5.4` route across the primary and inherited slots.
 - Recommended saved profile pattern: `gpt53-all` when the route is validated for `gpt-5.3-codex` across the main thread and helper lanes.
 - Recommended saved profile pattern: `kimi-main` or `glm-main` for provider-native routing with that provider's API URL and credential.