@bilalimamoglu/sift 0.3.0 → 0.3.1

package/README.md

@@ -49,6 +49,13 @@ That writes a machine-wide config to:
 
 After that, any terminal on the machine can use `sift`. A repo-local config can still override it later.
 
+To switch between saved native providers without editing YAML:
+
+```bash
+sift config use openai
+sift config use openrouter
+```
+
 If you prefer manual setup, this is the smallest useful OpenAI setup:
 
 ```bash
@@ -58,6 +65,13 @@ export SIFT_MODEL=gpt-5-nano
 export OPENAI_API_KEY=your_openai_api_key
 ```
 
+If you prefer manual setup, this is the smallest useful OpenRouter setup:
+
+```bash
+export SIFT_PROVIDER=openrouter
+export OPENROUTER_API_KEY=your_openrouter_api_key
+```
+
 Then check it:
 
 ```bash
@@ -130,6 +144,8 @@ sift exec --preset test-status -- <test command>
 
 If `standard` already names the main failure buckets, counts, and hints, stop there and read code.
 
+If `standard` still includes an unknown bucket or ends with `Decision: zoom`, do one deeper sift pass before you fall back to raw traceback.
+
 Then use this order:
 1. `sift exec --preset test-status -- <test command>`
 2. `sift rerun`
@@ -148,6 +164,8 @@ Most of the time, you do not need JSON. Start with text first.
 
 If `standard` already shows bucket-level root cause, `Anchor`, and `Fix`, do not re-verify the same bucket with raw pytest. At most do one targeted source read before you edit.
 
+If diagnose output still contains an unknown bucket or `Decision: zoom`, take one sift zoom step before raw traceback.
+
 Use diagnose JSON only when automation or machine branching really needs it:
 
 ```bash
@@ -378,6 +396,7 @@ Useful commands:
 
 ```bash
 sift config setup
+sift config use openrouter
 sift config init
 sift config show
 sift config validate
@@ -430,10 +449,14 @@ runtime:
   rawFallback: true
 ```
 
-## OpenAI vs OpenAI-compatible
+## OpenAI vs OpenRouter vs OpenAI-compatible
 
 Use `provider: openai` for `api.openai.com`.
 
+Use `provider: openrouter` for the native OpenRouter path. It defaults to:
+- `baseUrl: https://openrouter.ai/api/v1`
+- `model: openrouter/free`
+
 Use `provider: openai-compatible` for third-party compatible gateways or self-hosted endpoints.
 
 For OpenAI:
@@ -441,6 +464,11 @@ For OpenAI:
 export OPENAI_API_KEY=your_openai_api_key
 ```
 
+For OpenRouter:
+```bash
+export OPENROUTER_API_KEY=your_openrouter_api_key
+```
+
 For third-party compatible endpoints, use either the endpoint-native env var or:
 
 ```bash