You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8885d74
Browse filesBrowse the repository at this point in the historyBrowse files
docs: opencode 1.17.10 npm-spec 로드 버그 안내 + file:// 워크어라운드 추가
opencode 1.17.10(OpenTUI 0.4.2 회귀, anomalyco/opencode#33884)에서 npm 패키지 spec으로 로드되는 TUI 플러그인이 조용히 로드 실패하는 문제를 README 상단 경고로 명시하고, git clone + file:// 절대경로 로드 워크어라운드를 추가. 기존 npm 설치 사용자가 AI 에이전트에 붙여넣어 자동 전환할 수 있는 프롬프트도 포함.
Copy file name to clipboardExpand all lines: README.md
+36Lines changed: 36 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,6 +29,42 @@ Click either header (`▼`/`▶`) to collapse that section independently.
29
29
30
30
## Install
31
31
32
+
> [!WARNING]
33
+
> **opencode 1.17.10 breaks TUI plugins installed by npm package spec** ([anomalyco/opencode#33884](https://github.com/anomalyco/opencode/issues/33884)): the sidebar silently never renders. It is an opencode-side regression (OpenTUI 0.3.4 → 0.4.2) that affects *every* npm-spec TUI plugin — not just this one — and is slated to be fixed in a future opencode release. **Until then, use the `file://` workaround below.** The plain npm install further down works again once that fix ships.
A `file://` path lives outside `node_modules`, so opencode runs its Solid JSX transform on it and binds it to the host renderer — exactly why it loads when the npm spec does not. Clone the repo and point opencode at the local source:
Then set **`~/.config/opencode/tui.json`** to the absolute local path (replace any `opencode-usage-sidebar` entry, and use *your* real home directory):
Restart opencode. Update later with `git -C ~/.opencode-plugins/opencode-usage pull`. Options work the same way — pass them as the second element of the entry (see [Options](#options)).
56
+
57
+
#### Let an AI agent switch it for you
58
+
59
+
Already installed via the npm spec? Paste this to your opencode / Claude agent and it will do the switch:
60
+
61
+
> opencode 1.17.10 has bug #33884 that silently breaks npm-spec TUI plugins. Set up `opencode-usage-sidebar` as a local `file://` plugin instead:
> 2. Edit `~/.config/opencode/tui.json`: remove any plugin entry whose name starts with `opencode-usage-sidebar`, and add `["file://<ABS_PATH>/src/tui.tsx", { "enabled": true }]`, where `<ABS_PATH>` is the clone's real absolute path (expand `~` to my home directory). Keep my other plugins and any options I already had.
64
+
> 3. Then tell me to restart opencode and confirm the **Claude Usage** / **Codex Usage** panels appear.
0 commit comments