@thelioo/opencode-balancer 0.2.0 → 0.2.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.
- package/INSTALL.txt +7 -7
- package/README.md +5 -3
- package/package.json +1 -1
package/INSTALL.txt
CHANGED
|
@@ -11,7 +11,7 @@ Important rules
|
|
|
11
11
|
- Preserve existing opencode config, TUI config, plugins, comments, formatting, providers, agents, MCP servers, and permissions whenever possible.
|
|
12
12
|
- Use the singular key "plugin", not "plugins".
|
|
13
13
|
- Add the plugin only if it is not already present.
|
|
14
|
-
- Prefer @thelioo/opencode-balancer@latest for user installs.
|
|
14
|
+
- Prefer @thelioo/opencode-balancer (without @latest) for user installs.
|
|
15
15
|
- Keep config changes minimal and do not remove unrelated user settings.
|
|
16
16
|
|
|
17
17
|
Steps
|
|
@@ -27,7 +27,7 @@ Steps
|
|
|
27
27
|
- If the config is JSON, keep JSON syntax valid.
|
|
28
28
|
|
|
29
29
|
3. Add this plugin entry to the opencode config plugin array:
|
|
30
|
-
@thelioo/opencode-balancer
|
|
30
|
+
@thelioo/opencode-balancer
|
|
31
31
|
|
|
32
32
|
4. Locate the user's opencode TUI config.
|
|
33
33
|
- Prefer ~/.config/opencode/tui.jsonc if it exists.
|
|
@@ -41,7 +41,7 @@ Steps
|
|
|
41
41
|
- If the config is JSON, keep JSON syntax valid.
|
|
42
42
|
|
|
43
43
|
6. Add this plugin entry to the TUI config plugin array:
|
|
44
|
-
@thelioo/opencode-balancer
|
|
44
|
+
@thelioo/opencode-balancer
|
|
45
45
|
|
|
46
46
|
7. Save both configs.
|
|
47
47
|
|
|
@@ -52,13 +52,13 @@ Steps
|
|
|
52
52
|
Expected config shape
|
|
53
53
|
{
|
|
54
54
|
"$schema": "https://opencode.ai/config.json",
|
|
55
|
-
"plugin": ["@thelioo/opencode-balancer
|
|
55
|
+
"plugin": ["@thelioo/opencode-balancer"]
|
|
56
56
|
}
|
|
57
57
|
|
|
58
58
|
Expected TUI config shape
|
|
59
59
|
{
|
|
60
60
|
"$schema": "https://opencode.ai/tui.json",
|
|
61
|
-
"plugin": ["@thelioo/opencode-balancer
|
|
61
|
+
"plugin": ["@thelioo/opencode-balancer"]
|
|
62
62
|
}
|
|
63
63
|
|
|
64
64
|
After restart
|
|
@@ -87,8 +87,8 @@ TUI-only workflow
|
|
|
87
87
|
/balancer opens the Balancer dashboard in the TUI. Account management, provider/model priority, supported usage snapshots, and balancing settings are handled from the TUI only.
|
|
88
88
|
|
|
89
89
|
Verification
|
|
90
|
-
- Confirm the opencode config contains @thelioo/opencode-balancer
|
|
91
|
-
- Confirm the opencode TUI config contains @thelioo/opencode-balancer
|
|
90
|
+
- Confirm the opencode config contains @thelioo/opencode-balancer in the plugin array.
|
|
91
|
+
- Confirm the opencode TUI config contains @thelioo/opencode-balancer in the plugin array.
|
|
92
92
|
- Confirm no existing plugin entries were removed.
|
|
93
93
|
- Confirm the user restarted opencode after the config change.
|
|
94
94
|
- Confirm the Balancer dashboard opens with Ctrl+B, /balancer, or the command palette.
|
package/README.md
CHANGED
|
@@ -50,7 +50,7 @@ Add the plugin to your opencode config so the server hooks can run:
|
|
|
50
50
|
```json
|
|
51
51
|
{
|
|
52
52
|
"$schema": "https://opencode.ai/config.json",
|
|
53
|
-
"plugin": ["@thelioo/opencode-balancer
|
|
53
|
+
"plugin": ["@thelioo/opencode-balancer"]
|
|
54
54
|
}
|
|
55
55
|
```
|
|
56
56
|
|
|
@@ -59,10 +59,12 @@ Then add the same plugin to your opencode TUI config so the dashboard can load:
|
|
|
59
59
|
```json
|
|
60
60
|
{
|
|
61
61
|
"$schema": "https://opencode.ai/tui.json",
|
|
62
|
-
"plugin": ["@thelioo/opencode-balancer
|
|
62
|
+
"plugin": ["@thelioo/opencode-balancer"]
|
|
63
63
|
}
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
+
Use the package name without an explicit `@latest` tag so opencode can refresh to newer published versions on restart.
|
|
67
|
+
|
|
66
68
|
Then restart opencode. The same package provides both the server hooks and the TUI dashboard.
|
|
67
69
|
|
|
68
70
|
> [!TIP]
|
|
@@ -180,7 +182,7 @@ And add the same local path to your TUI config:
|
|
|
180
182
|
|
|
181
183
|
| Problem | What to try |
|
|
182
184
|
| --- | --- |
|
|
183
|
-
| Plugin does not load | Confirm `plugin` is singular in opencode config, restart opencode, and check that the package name is `@thelioo/opencode-balancer
|
|
185
|
+
| Plugin does not load | Confirm `plugin` is singular in opencode config, restart opencode, and check that the package name is `@thelioo/opencode-balancer`. |
|
|
184
186
|
| Dashboard does not open | Confirm `tui.json` also contains the plugin, restart opencode, then try `Ctrl+B`, `/balancer`, or the command palette. |
|
|
185
187
|
| Account was not saved | Use **New account** from the Balancer dashboard and complete opencode's native provider connection flow. |
|
|
186
188
|
| Provider is skipped | Open the priority matrix and confirm the provider is enabled and has a model selected. |
|
package/package.json
CHANGED