Startup shows blank screen for several seconds when plugins are configured · Issue #12666 · anomalyco/opencode · GitHub
Skip to content

Startup shows blank screen for several seconds when plugins are configured #12666

Closed

Description

@Rejudge-F

Description

When plugins (especially oh-my-opencode or other npm-based plugins) are configured, opencode startup takes several seconds with no visual feedback — just a blank black screen. This makes users think the application is frozen or their computer is stuck.

Root cause

The startup delay comes from multiple sequential blocking operations that happen before the TUI renders:

  1. getTerminalBackgroundColor() blocks up to 1000ms querying the terminal
  2. InstanceBootstrap runs lazily on the first API request, which includes:
    • Plugin.init() — installs plugins from npm (bun add) one by one, each acquiring a write lock
    • LSP.init() — spawns language server processes
    • FileWatcher.init(), Vcs.init(), etc.
  3. TUI-side sync.tsx bootstrap fetches providers, agents, config from the server

All of this happens with zero user feedback.

Expected behavior

Users should see what's happening during startup — a splash screen with progress logs showing each initialization step (plugin install, LSP init, etc.).

Environment

  • opencode with oh-my-opencode and other plugins configured
  • macOS / Linux terminal

Activity

  1. added
    perfIndicates a performance issue or need for optimization
    on Feb 8, 2026
  2. github-actions commented on Feb 8, 2026

    @github-actions
    Contributor

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

    These issues share the same symptom of extended blank/black screen delays during startup. The root causes may be related to plugin initialization, bootstrap delays, or system-specific performance issues. Feel free to ignore if your specific case involves plugins configured in oh-my-opencode (which may be a more specific subset of the broader startup delay problem).

  3. Rejudge-F commented on Feb 8, 2026

    @Rejudge-F
    Author
    Image
  4. github-actions commented on Apr 10, 2026

    @github-actions
    Contributor

    To stay organized issues are automatically closed after 90 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

perfIndicates a performance issue or need for optimization

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions