Skip to content

Commit 4923b3d

Browse files
committed
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 에이전트에 붙여넣어 자동 전환할 수 있는 프롬프트도 포함.
1 parent d418e2d commit 4923b3d

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,42 @@ A counter on the bottom-right of the prompt box. It measures elapsed time since
5555

5656
## Install
5757

58+
> [!WARNING]
59+
> **opencode 1.17.10 breaks TUI plugins installed by npm package spec** ([anomalyco/opencode#33884](https://github.com/anomalyco/opencode/issues/33884)): the sidebar panel 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.
60+
61+
### Workaround: `file://` install (opencode 1.17.10)
62+
63+
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:
64+
65+
```bash
66+
git clone https://github.com/coin-seeker/opencode-timeline.git ~/.opencode-plugins/opencode-timeline
67+
cd ~/.opencode-plugins/opencode-timeline && npm install
68+
```
69+
70+
Then set **`~/.config/opencode/tui.json`** to the absolute local path (replace any `opencode-timeline` entry, and use *your* real home directory):
71+
72+
```json
73+
{
74+
"$schema": "https://opencode.ai/tui.json",
75+
"plugin": [
76+
["file:///Users/YOU/.opencode-plugins/opencode-timeline/src/tui.tsx", { "enabled": true }]
77+
]
78+
}
79+
```
80+
81+
Restart opencode. Update later with `git -C ~/.opencode-plugins/opencode-timeline pull`. Options work the same way — pass them as the second element of the entry (see [Options](#options)).
82+
83+
#### Let an AI agent switch it for you
84+
85+
Already installed via the npm spec? Paste this to your opencode / Claude agent and it will do the switch:
86+
87+
> opencode 1.17.10 has bug #33884 that silently breaks npm-spec TUI plugins. Set up `opencode-timeline` as a local `file://` plugin instead:
88+
> 1. Clone & install: `git clone https://github.com/coin-seeker/opencode-timeline.git ~/.opencode-plugins/opencode-timeline && cd ~/.opencode-plugins/opencode-timeline && npm install`
89+
> 2. Edit `~/.config/opencode/tui.json`: remove any plugin entry whose name starts with `opencode-timeline`, 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.
90+
> 3. Then tell me to restart opencode and confirm the **Timeline** / **Agents** panels appear.
91+
92+
---
93+
5894
Paste below into your OpenCode.
5995

6096
```

0 commit comments

Comments
 (0)