Skip to content

OpenCode silently enters a broken UI state when a plugin fails to initialize #24847

Closed as not planned

Description

@BorisDay

Description

Expected behavior:

  • Option A: OpenCode should print a clear error on startup (e.g. "Plugin X not found — skipping" or "Plugin load failed: ...")
  • Option B: OpenCode should gracefully disable the broken plugin and continue with a degraded but functional UI
  • Option C: At minimum, the TUI should remain usable with a visible error indicator

Actual behavior:
Silent UI breakage. No error output anywhere. The user has no indication of what went wrong.

Root cause (from debugging):
The opencode.json plugin array referenced packages not present in ~/.config/opencode/node_modules/. OpenCode attempted to load them, failed silently, and the initialization of the input handler and agent status display never completed — leaving the TUI in a zombie state.

Workaround:
Remove uninstalled plugin entries from "plugin" array, or run npm install <plugin> in the config directory.
Why this matters for OpenCode specifically:
The TUI is the primary user interface. A silent failure that disables text input with zero diagnostics is critical — users naturally look for errors in logs or console output and find nothing.

Plugins

https://github.com/affaan-m/everything-claude-code

OpenCode version

1.14.28

Steps to reproduce

  1. Add a plugin entry to opencode.json that is NOT installed in node_modules/.
    Example: "plugin": ["opencode-antigravity-auth@1.3.0"]
  2. Run opencode from terminal.
  3. Observation: The TUI loads (no "Loading plugins..." hang), but:
    • The status bar shows no active agent name
    • Typing text and pressing Enter does nothing
    • No error message is printed to stdout/stderr

Screenshot and/or share link

No response

Operating System

WSL2 (Debian) on Windows 11

Terminal

TUI

Activity

  1. added
    coreAnything pertaining to core functionality of the application (opencode server stuff)
    on Apr 28, 2026
  2. github-actions commented on Apr 28, 2026

    @github-actions
    Contributor

    This issue might be a duplicate of existing issues. Please check:

    If your issue is distinct (e.g. it specifically involves missing node_modules entries rather than a local plugin error), please clarify how it differs.

  3. removed
    bugSomething isn't working
    coreAnything pertaining to core functionality of the application (opencode server stuff)
    on May 3, 2026
  4. github-actions commented on Jul 3, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions