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

Open
opened 2026-02-16 18:10:55 -05:00 by yindo · 2 comments
Owner

Originally created by @Rejudge-F on GitHub (Feb 8, 2026).

Originally assigned to: @thdxr on GitHub.

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
Originally created by @Rejudge-F on GitHub (Feb 8, 2026). Originally assigned to: @thdxr on GitHub. ## 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
yindo added the perf label 2026-02-16 18:10:55 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Feb 8, 2026):

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

  • #11374: Blank screen for ~10 seconds on startup when running inside a VM or container
  • #10221: Black screen on just installed opencode
  • #12491: Windows 11: GUI opens but stays blank, no logs, bun processes running

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).

@github-actions[bot] commented on GitHub (Feb 8, 2026): This issue might be a duplicate of existing issues. Please check: - #11374: Blank screen for ~10 seconds on startup when running inside a VM or container - #10221: Black screen on just installed opencode - #12491: Windows 11: GUI opens but stays blank, no logs, bun processes running 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).
Author
Owner

@Rejudge-F commented on GitHub (Feb 8, 2026):

Image
@Rejudge-F commented on GitHub (Feb 8, 2026): <img width="1746" height="1054" alt="Image" src="https://github.com/user-attachments/assets/3d2a02ec-6426-4cf3-8a11-321a980bfbb6" />
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#8816