@alexeiled/claude-router 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,62 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 594 477" role="img" aria-labelledby="title desc">
2
+ <title id="title">Router pane, Tiers tab</title>
3
+ <desc id="desc">Model and effort per tier with prices and windows, the baseline tier, how the policy prices each step up, and the router.json change Save routes will write.</desc>
4
+ <style>
5
+ text { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace; font-size: 13px; }
6
+ .cap { font-family: system-ui, -apple-system, 'Segoe UI', sans-serif; font-size: 12px; fill: #9a988f; }
7
+ </style>
8
+ <rect width="594" height="477" rx="8" fill="#1c1c1c"/>
9
+ <rect x="10" y="10" width="574" height="457" rx="6" fill="none" stroke="#3f5f8f"/>
10
+ <text x="24.0" y="34" fill="#5fafd7" font-weight="700" xml:space="preserve">ROUTER · Auto</text>
11
+ <text x="148.8" y="34" fill="#87d787" xml:space="preserve">Jev ready · 347 ms</text>
12
+ <text x="24.0" y="53" fill="#87afff" font-weight="700" xml:space="preserve">[ Auto ]</text>
13
+ <text x="94.2" y="53" fill="#d0d0d0" xml:space="preserve">[ Manual: keep /model ]</text>
14
+ <text x="24.0" y="72" fill="#d0d0d0" xml:space="preserve">[ Now ]</text>
15
+ <text x="86.4" y="72" fill="#87afff" font-weight="700" xml:space="preserve">[ Tiers ]</text>
16
+ <text x="164.4" y="72" fill="#d0d0d0" xml:space="preserve">[ Tuning ]</text>
17
+ <text x="250.2" y="72" fill="#d0d0d0" xml:space="preserve">[ Usage ]</text>
18
+ <text x="328.2" y="72" fill="#d0d0d0" xml:space="preserve">[ ? ]</text>
19
+ <text x="24.0" y="110" fill="#5fafd7" font-weight="700" xml:space="preserve">ROUTES · future turns</text>
20
+ <text x="24.0" y="129" fill="#7c7c7c" xml:space="preserve">tier model effort $/M in · out window</text>
21
+ <text x="24.0" y="148" fill="#e0708a" font-weight="700" xml:space="preserve">high</text>
22
+ <text x="86.4" y="148" fill="#d0d0d0" xml:space="preserve">Opus 5.5 ▾</text>
23
+ <text x="195.6" y="148" fill="#d0d0d0" xml:space="preserve">xhigh ▾</text>
24
+ <text x="289.2" y="148" fill="#d0d0d0" xml:space="preserve">4 · 20</text>
25
+ <text x="398.4" y="148" fill="#d0d0d0" xml:space="preserve">1M</text>
26
+ <text x="24.0" y="167" fill="#d7af5f" font-weight="700" xml:space="preserve">medium</text>
27
+ <text x="86.4" y="167" fill="#d0d0d0" xml:space="preserve">Sonnet 5.5 ▾</text>
28
+ <text x="195.6" y="167" fill="#d0d0d0" xml:space="preserve">xhigh ▾</text>
29
+ <text x="289.2" y="167" fill="#d0d0d0" xml:space="preserve">2 · 10</text>
30
+ <text x="398.4" y="167" fill="#d0d0d0" xml:space="preserve">1M</text>
31
+ <text x="414.0" y="167" fill="#d7af5f" xml:space="preserve"> ●</text>
32
+ <text x="24.0" y="186" fill="#5f9fe0" font-weight="700" xml:space="preserve">low</text>
33
+ <text x="86.4" y="186" fill="#d0d0d0" xml:space="preserve">Sonnet 5.5 ▾</text>
34
+ <text x="195.6" y="186" fill="#d0d0d0" xml:space="preserve">session ▾</text>
35
+ <text x="289.2" y="186" fill="#d0d0d0" xml:space="preserve">2 · 10</text>
36
+ <text x="398.4" y="186" fill="#d0d0d0" xml:space="preserve">1M</text>
37
+ <text x="24.0" y="205" fill="#5fd7af" font-weight="700" xml:space="preserve">micro</text>
38
+ <text x="86.4" y="205" fill="#d0d0d0" xml:space="preserve">Haiku 4.5 ▾</text>
39
+ <text x="195.6" y="205" fill="#7c7c7c" xml:space="preserve">none</text>
40
+ <text x="289.2" y="205" fill="#d0d0d0" xml:space="preserve">1 · 5</text>
41
+ <text x="398.4" y="205" fill="#d0d0d0" xml:space="preserve">200K</text>
42
+ <text x="24.0" y="224" fill="#d0d0d0" xml:space="preserve">Baseline tier: low ▾</text>
43
+ <text x="180.0" y="224" fill="#7c7c7c" xml:space="preserve"> start here, fall back here</text>
44
+ <text x="24.0" y="262" fill="#5fafd7" font-weight="700" xml:space="preserve">SWITCH COST · from these routes</text>
45
+ <text x="24.0" y="281" fill="#7c7c7c" xml:space="preserve">· </text>
46
+ <text x="39.6" y="281" fill="#d0d0d0" xml:space="preserve">medium → high </text>
47
+ <text x="164.4" y="281" fill="#d0d0d0" xml:space="preserve">model change: priced as a cold cache write</text>
48
+ <text x="24.0" y="300" fill="#7c7c7c" xml:space="preserve">· </text>
49
+ <text x="39.6" y="300" fill="#d0d0d0" xml:space="preserve">low → medium </text>
50
+ <text x="164.4" y="300" fill="#d0d0d0" xml:space="preserve">same model, new effort: priced as a new cache</text>
51
+ <text x="24.0" y="319" fill="#7c7c7c" xml:space="preserve">· </text>
52
+ <text x="39.6" y="319" fill="#d0d0d0" xml:space="preserve">micro → low </text>
53
+ <text x="164.4" y="319" fill="#d0d0d0" xml:space="preserve">model change: priced as a cold cache write</text>
54
+ <text x="24.0" y="357" fill="#7c7c7c" xml:space="preserve">router.json changes:</text>
55
+ <text x="24.0" y="376" fill="#e06c6c" xml:space="preserve">- routes.medium Opus 5.5 · medium</text>
56
+ <text x="24.0" y="395" fill="#87d787" xml:space="preserve">+ routes.medium Sonnet 5.5 · xhigh</text>
57
+ <text x="24.0" y="414" fill="#87afff" font-weight="700" xml:space="preserve">[ Save routes ]</text>
58
+ <text x="148.8" y="414" fill="#d0d0d0" xml:space="preserve">[ Discard ]</text>
59
+ <text x="242.4" y="414" fill="#d0d0d0" xml:space="preserve">[ Reset to defaults ]</text>
60
+ <text x="24.0" y="433" fill="#7c7c7c" xml:space="preserve">A new model ID needs router.json → models: price, window, efforts.</text>
61
+ <text x="24.0" y="452" fill="#d0d0d0" xml:space="preserve">[ Close ]</text>
62
+ </svg>
@@ -19,50 +19,73 @@ In Claude Code:
19
19
 
20
20
  1. Run `/plugin configure router`.
21
21
  2. Select the Jev API key option, enter the key, and save it.
22
- 3. Run `/router auto`.
22
+ 3. Check the band above the prompt: `▂▄▆█ Auto · ready`. On another model the session starts in Manual; run `/router auto` to route.
23
23
 
24
24
  The key is stored as a sensitive plugin option. Do not paste it into a model conversation. The [configuration guide](configuration.md) covers optional settings and the old v0.8 migration.
25
25
 
26
26
  ## Read the status band
27
27
 
28
- The Mod adds a band above the prompt and a **Router** button. It reports whether routing is ready, choosing a route, in Manual mode, pinned, degraded, or unavailable. After a reply, it shows the actual model, effort, and reason.
28
+ Router draws one line above the prompt. The line ends with a **Router** button that opens the pane. When the band is narrow, the less important parts drop first: classifier figures, then context and cache, then the reason. The tier and model always stay.
29
29
 
30
- | Status | Meaning |
31
- | ----------------------------------------------- | ----------------------------------------------------------------------- |
32
- | `Auto · ready` | Auto mode is ready for a new turn. |
33
- | `choosing for this turn…` | Jev advice and local policy are in progress. |
34
- | `key not set · keeping …` | No Jev key is available. The current model stays active. |
35
- | `Jev timeout`, `Jev auth`, or `Jev unreachable` | Jev failed. The current model stays active. |
36
- | `Jev paused until …` | Three launched failures opened a 60-second breaker. |
37
- | `context unknown · keeping native model` | The router could not verify that a smaller window has enough room. |
38
- | `native fallback` | Claude Code substituted another available model for the selected route. |
39
- | `requires Claude Code 2.1.289 or newer` | This version cannot run the router controls. |
30
+ ![Five band states: routed to high, two rows with the hover row, a pending pin, a missing classifier key, and Manual mode](router-band.svg)
31
+
32
+ Read the first line of the picture from left to right:
33
+
34
+ - **Tier meter** `▂▄▆█`: one bar per tier, lit up to the current tier in its color, like signal strength.
35
+ - **Tier and model**: the route for this turn. **fallback** means Claude Code answered with another model.
36
+ - **Reason**: one or two words with a direction, such as `↑ jump`, `↓ downgrade`, `= fits`, or `… waiting to go down`.
37
+ - **Classifier support**: what Jev gave the switch against the bar the policy required.
38
+ - **ctx** and **cache**: context use and cache reuse on the last reply. They turn yellow at 60% context and red at 80%.
39
+
40
+ | Band shows | Meaning |
41
+ | ------------------------------------------- | ------------------------------------------------------------------------------------- |
42
+ | `Auto · ready` | Auto mode is ready for a new turn. |
43
+ | `choosing for this turn…` | The classifier and local policy are running. The spinner says `Choosing model`. |
44
+ | `⏵ next turn: high ✕` | A pin is set. **✕** cancels it. |
45
+ | `⚠ Jev key not set · keeping model` | No key is available. **Set key** opens the secure plugin dialog. |
46
+ | `⚠ Jev timed out · keeping model` | The classifier failed: timed out, unreachable, rejected the key, or paused. |
47
+ | `○ Router off · keeping …` | Manual mode. **Auto** resumes routing. The footer also shows `router off`. |
48
+ | `✕ Router unavailable` | Nothing routes: an old Claude Code or leftover v0.8 settings. **Fix** opens the pane. |
49
+ | `○ Router · subagents keep their own model` | You are viewing a subagent's transcript, which Router does not route. |
50
+
51
+ Hover over the band for a second row: pin a tier for the next turn, switch to Manual, or show two rows. The two-row band adds a strip of recent replies colored by tier, the switch count, the switch tax, and the cache saving. Router remembers that choice across sessions. When Router changes the model between turns, a toast shows the old and new model and the reason. A pin does not raise one, and neither does a change of effort alone.
52
+
53
+ The band steps aside while a survey needs the space.
40
54
 
41
55
  Tool continuations do not trigger another classification. Subagent choices remain unchanged.
42
56
 
43
57
  ## Open the router pane
44
58
 
45
- Run `/router` or select **Router** above the prompt. In a terminal without a UI surface, `/router` prints a short status instead. `/router status` always prints the short status.
59
+ Run `/router` or select **Router** above the prompt. Without a UI surface, as in `claude -p`, `/router` prints a short status instead. The pane has four tabs. Select a tab or press its digit while the pane has focus.
46
60
 
47
- The pane groups information by purpose:
61
+ ![The Now tab: the route and reason, classifier support per tier with pin buttons, recent replies by tier, and context, cache and cost](router-pane-now.svg)
48
62
 
49
- | Pane section | What it shows |
50
- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
51
- | Model routing | Auto or Manual, last actual reply, requested model, effort, route reason, and any next-turn pin. |
52
- | Usage | Claude-reported API cost, context bar, observed and estimated input, cache read/write, output, and a ten-response input trend. |
53
- | Jev and switch estimate | Jev status and last classification time, suggested tier, policy support, and estimated switch cost. |
54
- | Controls | Auto, Manual, tier pins, and secure key configuration. |
55
- | Tuning | Jev deadline, votes before downgrade, and payback horizon. Save applies changes to future turns. |
63
+ The **Now** tab answers "what runs next turn, and why". The ladder lists the tiers from strongest to cheapest with the route each one uses. The bar is the support the classifier gave that tier on the last turn. The line under the ladder compares the support for a switch with the bar the policy required and shows the estimated switch tax. **pin** forces that tier for the next turn only.
64
+
65
+ ![The Tiers tab: model and effort per tier, the baseline tier, how each step up is priced, and the router.json change to save](router-pane-tiers.svg)
66
+
67
+ The **Tiers** tab edits the routes. In the picture, `medium` was changed to Sonnet 5.5 at `xhigh`: the tier shows **●**, the switch-cost lines now price `medium → high` as a model change, and the diff lists the one `router.json` line that **Save routes** will write. [Edit tiers](#edit-tiers) explains the controls.
68
+
69
+ | Tab | What it shows |
70
+ | ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
71
+ | 1 Now | The current tier, model, and reason; Jev's support for each tier with a **pin** button; the last 30 replies by tier; context and cache. |
72
+ | 2 Tiers | The model and effort for each tier, the baseline tier, the cache cost of each step up, and the `router.json` change to save. |
73
+ | 3 Tuning | Jev deadline, downgrade votes, payback horizon, credits cap, the Jev key, and the `router.json` path. |
74
+ | 4 Usage | Claude-reported cost, context and cache detail, input per reply, quota, and configured-price estimates. |
75
+
76
+ **Auto** and **Manual: keep /model** stay at the top of every tab. **?** shows what the estimates leave out.
56
77
 
57
78
  ### Understand usage and estimates
58
79
 
59
- - **API cost reported by Claude** comes from Claude Code's native usage API. If the account is on a plan, a configured list-price estimate is not the subscription cash charge.
80
+ - **Cost** comes from Claude Code's native usage API. If the account is on a plan, a configured list-price estimate is not the subscription cash charge.
60
81
  - **Context** compares the larger available context reading with the routed model's configured window. The router reserves 20% of that window. Values can be unknown when Claude does not provide the needed estimate.
61
- - **Cache read / written** and **Output** are observed response counters. The cache reuse bar uses cache-read tokens divided by that response's input counters.
62
- - **Input trend** shows up to ten observed main-conversation response sizes. It is a scale comparison, not a forecast.
82
+ - **Cache** reuse is cache-read tokens divided by the last response's input counters.
83
+ - **Jev support** is the probability Jev gave each tier on the last classified turn. The line under it compares the support for a switch with the bar the policy required, and shows the estimated switch tax.
84
+ - **Replies** colors each of the last 30 main-conversation replies by the tier that served it. A dot marks a reply the router did not choose, such as one in Manual mode.
85
+ - **Input per reply** scales the last 30 input sizes from the lowest to the highest reading. It is a scale comparison, not a forecast.
63
86
  - **Cache read benefit** is a configured-price estimate for cached reads before write costs. It is not a measured saving.
64
87
  - **Next-turn difference** compares the candidate with the current model under five-minute and one-hour cache-write scenarios. A negative number means the candidate is estimated to cost less for that request.
65
- - **Conservative payback** estimates later turns to recover an initial difference under assumed future cache reads and the last observed output size. It does not guarantee savings.
88
+ - **Payback** estimates later turns to recover an initial difference under assumed future cache reads and the last observed output size. It does not guarantee savings.
66
89
 
67
90
  There is no router-side spend or savings ledger. The pane does not include Jev charges. Claude's native `/cost` is the source for its reported API cost.
68
91
 
@@ -70,29 +93,40 @@ There is no router-side spend or savings ledger. The pane does not include Jev c
70
93
 
71
94
  | Command or action | Result |
72
95
  | ---------------------------------------- | --------------------------------------------------------------------------- |
96
+ | `/router` | Open the pane. |
73
97
  | `/router auto` | Resume automatic routing. |
74
98
  | `/router off` | Enter Manual mode and preserve Claude's selected model. |
75
- | `/model <name>` | Select a model and enter Manual mode. Use `/router auto` to resume. |
76
99
  | `/router pin <micro\|low\|medium\|high>` | Pin the next turn and its tool continuations. Auto must already be enabled. |
77
- | **Auto routing** button | Resume automatic routing. |
78
- | **Manual model** button | Preserve Claude's selected model. |
79
- | A tier button in the pane | Pin the next turn. Auto must already be enabled. |
100
+ | `/model <name>` | Select a model and enter Manual mode. Use `/router auto` to resume. |
101
+ | **Auto** / **Manual: keep /model** | The same as `/router auto` and `/router off`. |
102
+ | **pin** on the Now tab | Pin that tier for the next turn. Auto must already be enabled. |
103
+
104
+ A pin does not change the next turn after the pinned turn finishes. A fresh session on the baseline model starts in Auto. A fresh session on another model starts in Manual. `/clear` starts the new session in Auto. Resuming a saved session restores its saved Auto or Manual mode.
105
+
106
+ ## Edit tiers
107
+
108
+ On the **Tiers** tab, pick a model and an effort for any tier. The model list comes from the aliases in `router.json` `models`, limited by the `availableModels` setting. `session` keeps the effort Claude Code sends. A model without effort levels, such as Haiku, shows `none`.
109
+
110
+ Changed tiers show **●**. The tab lists the `router.json` lines that **Save routes** will write. **Discard** drops the draft. **Reset to defaults** loads the built-in routes; saving then removes your route overrides from `router.json`. A saved change applies from the next turn.
80
111
 
81
- A pin does not change the next turn after the pinned turn finishes. A fresh session on the baseline model starts in Auto. A fresh session on another model starts in Manual. Resuming a saved session restores its saved Auto or Manual mode.
112
+ **Switch cost** reads the draft from the bottom tier up and shows how the policy prices each step. A model change is priced as a cold cache write. An effort change on the same model is also priced as a new messages cache; whether the API actually keeps the cache across an effort change is not measured. Two identical tiers make that step change nothing.
113
+
114
+ A new model ID needs an entry in `router.json` `models` with its price, context window, and effort levels. See [Configuration](configuration.md).
82
115
 
83
116
  ## Tune future decisions
84
117
 
85
- Select the tuning values in the pane, then select **Save tuning**. The three controls are:
118
+ On the **Tuning** tab, pick the values, then select **Save tuning**:
86
119
 
87
120
  - **Jev deadline:** 500, 1,000, 1,500, or 3,000 ms for the total advice attempt, including any retry.
88
- - **Votes before cheaper tier:** 1, 2, or 3 consecutive votes.
121
+ - **Votes to go down:** 1, 2, or 3 consecutive votes before a cheaper tier.
89
122
  - **Payback horizon:** 1, 3, 5, or 10 later turns used by the downgrade estimate.
123
+ - **Credits cap:** $0.50, $1, $2, or $5 for an estimated cold cache write on a `credits` model.
90
124
 
91
- The current turn keeps the settings it started with. A saved tuning change applies to later turns. The pane preserves unrelated `router.json` keys and refuses to write through a symlink. For other supported settings, see [Configuration](configuration.md).
125
+ The current turn keeps the settings it started with. A save preserves unrelated `router.json` keys and refuses to write through a symlink. When validation fails, the pane names the setting and leaves the file unchanged. **Set Jev key** or **Edit key** opens Claude Code's secure plugin configuration.
92
126
 
93
127
  ## Move from v0.8 gateway setup
94
128
 
95
- The v1 plugin has the same plugin ID, `router@alexei-led-claude-router`, but it does not start the v0.8 local gateway. Marketplace installs with auto-update receive v1 at the next start. Before the first v1 session:
129
+ The v1 plugin has the same plugin ID, `router@alexei-led-claude-router`, but it does not start the v0.8 local gateway. With auto-update on, Claude Code installs v1 at the next start. Before the first v1 session:
96
130
 
97
131
  1. Update the plugin: `claude plugin marketplace update alexei-led-claude-router`, then `claude plugin update router@alexei-led-claude-router`.
98
132
  2. Remove the settings that v0.8 `/router:setup` wrote. The [migration checklist](configuration.md#convert-a-v08-configuration) lists them: the `jev-router[1m]` model and picker row, the loopback `ANTHROPIC_BASE_URL`, the hint header, and the router status line.
@@ -103,31 +137,21 @@ Keep the plugin enabled: in v1 it is the Mod. The Jev key option keeps its saved
103
137
 
104
138
  ## Update or stop
105
139
 
106
- Marketplace installs update with `claude plugin update router@alexei-led-claude-router`. For a local checkout, update the files and restart Claude Code with the same `--plugin-dir`.
140
+ Claude Code updates a marketplace install at startup when auto-update is on for the marketplace. To update now, run `claude plugin marketplace update alexei-led-claude-router`, then `claude plugin update router@alexei-led-claude-router`, and restart. For a local checkout, update the files and restart Claude Code with the same `--plugin-dir`.
107
141
 
108
142
  To stop routing for a session, run `/router off`. To stop loading the Mod, run `claude plugin disable router@alexei-led-claude-router`, or restart without `--plugin-dir` for a checkout. The Mod keeps no session ledger and starts no process.
109
143
 
110
- ## Roll back to v0.8.0
111
-
112
- v0.8.0 stays available as the signed git tag `v0.8.0` and as `@alexeiled/claude-router@0.8.0` on npm.
113
-
114
- 1. Disable the v1 plugin: `claude plugin disable router@alexei-led-claude-router`.
115
- 2. Check out the tag: `git clone --branch v0.8.0 https://github.com/alexei-led/claude-router ~/claude-router-0.8.0`.
116
- 3. If you converted `router.json`, restore the original: `mv ~/.claude/router.json.v0.8.backup ~/.claude/router.json`. v0.8.0 rejects the converted file.
117
- 4. Start Claude Code with `--plugin-dir ~/claude-router-0.8.0` and run `/router:setup`. It writes the gateway settings again. Restart.
118
-
119
- Launch with that `--plugin-dir` each time. Do not enable v1 and v0.8 together.
120
-
121
144
  ## Troubleshooting
122
145
 
123
- | Symptom | Cause | Fix |
124
- | --------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
125
- | Status says the Jev key is missing | The plugin option is unset or unavailable to this process. | Run `/plugin configure router`, save the option, and start a new turn. |
126
- | Route stays on the current model | Jev timed out, failed, is paused, or network policy refused the request. | Read the status band and `/router status`. Network policy refusal is not bypassed. |
127
- | `/model` changed but routing stopped | Choosing a model enters Manual mode. | Run `/router auto` to resume automatic routing. |
128
- | Router reports invalid configuration | `router.json` is invalid, or project/local settings redirect the router profile. | Inspect `router.json`, remove project/local `HOME` or `CLAUDE_CONFIG_DIR` overrides, or run the [migration command](configuration.md#convert-a-v08-configuration). |
129
- | Router says old settings need migration | `router.json` still contains v0.8 gateway keys. | Run the [migration command](configuration.md#convert-a-v08-configuration). |
130
- | Router controls are unavailable | Claude Code is older than 2.1.289, or a gateway alias or loopback base URL is still active. | Update Claude Code and remove the old gateway model/base URL from the launcher. |
131
- | Context reads as unknown | The router lacks a reliable local estimate or current-history measurement. | Keep using the current model, or start a new history with a supported context estimate. |
146
+ | Symptom | Cause | Fix |
147
+ | ----------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
148
+ | Status says the Jev key is missing | The plugin option is unset or unavailable to this process. | Select **Set Jev key** in the pane, or run `/plugin configure router`. Save the option and start a new turn. |
149
+ | Route stays on the current model | Jev timed out, failed, is paused, or network policy refused the request. | Read the status band and the pane header. Network policy refusal is not bypassed. |
150
+ | `/model` changed but routing stopped | Choosing a model enters Manual mode. | Run `/router auto` to resume automatic routing. |
151
+ | Router reports invalid configuration | `router.json` is invalid, or project/local settings redirect the router profile. | Inspect `router.json`, remove project/local `HOME` or `CLAUDE_CONFIG_DIR` overrides, or run the [migration command](configuration.md#convert-a-v08-configuration). |
152
+ | Router says old settings need migration | `router.json` still contains v0.8 gateway keys. | Run the [migration command](configuration.md#convert-a-v08-configuration). |
153
+ | Band reads `v0.8 gateway settings remain` | The `jev-router[1m]` model or the `127.0.0.1:43170` base URL is still set. | Run `/router`: it lists the keys. Remove them as in the [migration checklist](configuration.md#convert-a-v08-configuration) and restart. |
154
+ | Router controls are unavailable | Claude Code is older than 2.1.289. | Update Claude Code. |
155
+ | Context reads as unknown | The router lacks a reliable local estimate or current-history measurement. | Keep using the current model, or start a new history with a supported context estimate. |
132
156
 
133
157
  For the internal event flow and network deadline behavior, see [Architecture](architecture.md). For what the test traces do and do not show, see [Evaluation](evaluation.md).