@thomas-huang/caosi 0.1.4 → 0.2.0

package/README.md

@@ -2,9 +2,19 @@
 
 [中文](README.zh-CN.md)
 
-A local converter between LLM client protocols and named upstream providers. Point Claude Code, Codex, or Gemini CLI at `http://127.0.0.1:9999/{provider_name}`. Same protocol is passed through; OpenAI Chat, OpenAI Responses, Claude Messages, and Gemini are converted when they differ.
+Keep using Claude Code, Codex, or Gemini CLI. Point them at your own upstream — no client switch.
 
-caosi is a converter, not a gateway.
+Set the Base URL to `http://127.0.0.1:9999/{provider_name}`. Same protocol is passed through; caosi converts when they differ.
+
+- A single static binary
+- npm ships the binaries: no install script, nothing fetched from GitHub
+- macOS, Linux, and Windows
+
+```bash
+npm install -g @thomas-huang/caosi
+```
+
+No Web UI, no OAuth, no key pool, no client-config rewrite. One process, one file, loopback only.
 
 ## Install
 
@@ -23,7 +33,7 @@ The first start writes a sample Provider File and exits. That is intentional: ca
 caosi
 ```
 
-Edit `~/.caosi/providers.jsonc`. Set `api_key` and `base_url`. If Claude Code will talk to an OpenAI-compatible upstream, keep `model` (for example `deepseek-chat`) so the upstream does not see `claude-*`.
+Edit `~/.caosi/providers.jsonc`. Set `api_key` and `base_url`. If Claude Code will talk to an OpenAI-compatible upstream, keep `model` (for example `qwen/qwen3-coder`) so the upstream does not see `claude-*`.
 
 Start again:
 
@@ -35,26 +45,26 @@ curl -s http://127.0.0.1:9999/health
 ## Point Claude Code at it
 
 ```bash
-export ANTHROPIC_BASE_URL=http://127.0.0.1:9999/deepseek
+export ANTHROPIC_BASE_URL=http://127.0.0.1:9999/openrouter
 export ANTHROPIC_API_KEY=dummy
 claude
 ```
 
-Replace `deepseek` with your Provider Name. caosi ignores the client key and uses the Provider's `api_key`. Claude Code sends `/v1/messages`; caosi converts when the upstream is not Claude.
+Replace `openrouter` with your Provider Name. caosi ignores the client key and uses the Provider's `api_key`. Claude Code sends `/v1/messages`; caosi converts when the upstream is not Claude.
 
 ## Codex / OpenAI and Gemini CLI
 
 OpenAI SDK, Chat Completions, and Codex:
 
 ```bash
-export OPENAI_BASE_URL=http://127.0.0.1:9999/deepseek/v1
+export OPENAI_BASE_URL=http://127.0.0.1:9999/openrouter/v1
 export OPENAI_API_KEY=dummy
 ```
 
 Gemini CLI (`~/.gemini/.env` or the environment):
 
 ```bash
-export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
+export GEMINI_API_BASE=http://127.0.0.1:9999/openrouter
 ```
 
 ## Provider File
@@ -63,11 +73,11 @@ export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
 
 ```jsonc
 {
-  "deepseek": {
-    "base_url": "https://api.deepseek.com",
+  "openrouter": {
+    "base_url": "https://openrouter.ai/api",
     "protocol": "openai_chat",
     "api_key": "sk-...",
-    "model": "deepseek-chat"
+    "model": "qwen/qwen3-coder"
   }
 }
 ```
@@ -81,7 +91,7 @@ export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
 
 - `model` is optional: when set, it replaces the client's model name on the upstream request.
 - `headers` is optional extra request headers (for example OpenRouter).
-- `base_url` is a prefix. caosi does not strip `/v1`. Use the root the upstream actually expects (`https://api.deepseek.com`, not `https://api.deepseek.com/v1`).
+- `base_url` is a prefix. caosi does not strip `/v1`. Use the root the upstream actually expects (`https://openrouter.ai/api`, not `https://openrouter.ai/api/v1`).
 
 ## Listen, health, reload
 
@@ -92,6 +102,8 @@ export GEMINI_API_BASE=http://127.0.0.1:9999/deepseek
 
 ## What it does not do
 
+caosi is a converter, not a gateway.
+
 No Web UI, OAuth, failover, key pools, or rewriting your Claude Code / Codex / Gemini config files.
 
 ## Without Node.js
@@ -105,7 +117,7 @@ go install github.com/thomas-huang/caosi/cmd/caosi@latest
 go test ./...
 ```
 
-Domain language: [CONTEXT.md](CONTEXT.md). Decisions: [docs/adr](docs/adr).
+Domain language: [CONTEXT.md](CONTEXT.md). Architecture: [docs/architecture.md](docs/architecture.md). Decisions: [docs/adr](docs/adr).
 
 To cut a release, push a tag `vX.Y.Z`. GitHub Actions builds the five binaries, writes checksums, creates the Release, and publishes `@thomas-huang/caosi` to npm with GitHub OIDC trusted publishing (no access token).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thomas-huang/caosi",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Local converter between LLM client protocols and named upstream providers",
   "license": "MIT",
   "homepage": "https://github.com/thomas-huang/caosi",