Repository navigation
TUI hangs on black screen when plugin dependencies are missing #14433
Description
When a plugin's dependencies can't be resolved (e.g. node_modules doesn't exist for @opencode-ai/plugin), the TUI stalls on a black screen indefinitely. No error is shown.
opencode run --print-logs surfaces the underlying error:
ERROR service=default name=ResolveMessage message=Cannot find module '@opencode-ai/plugin' from '/Users/matt/repos/dotfiles/.config/opencode/plugin/git-worktree.ts'
The import() failure rejects the state() initializer promise, which State.create() caches permanently. Every subsequent API request returns the same rejection, and the TUI never transitions past the loading screen.
Fix: #14432
Activity
github-actions commentedon Feb 20, 2026
This issue might be a duplicate of or related to existing issues. Please check:
Cannot find module '@opencode-ai/plugin'error, though that issue focuses on the module resolution failure itself rather than the TUI black screen / UX regression.