black screen when using >1.0.46

[wolfie82]

Description

Upgraded to opencode 1.0.47. When launching opencode I just see a black screen and the tui doesn't load. The issue is resolved by reverting to 1.0.46.

I have to kill the process manually.

OpenCode version

1.0.47

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

macOS 15.7

Terminal

iTerm2

[github-actions]

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

• Black screen when running opencode web in v1.0.17 (blocked insecure content / CORS errors) #3853: Black screen when running opencode web - similar black screen symptom on macOS with version-specific issue
• Screen becomes completely blank #3776: Screen becomes completely blank - TUI becomes blank during sessions on macOS
• Unstable TUI #3935: Unstable TUI - reports disappearing content area and UI instability since v1.0 on macOS
• 1.0+ is unusable in non-truecolor terminal #3671: 1.0+ is unusable in non-truecolor terminal - UI problems specifically starting with v1.0+ on macOS
• TUI themes became dim #4043: TUI themes became dim - visual display issues in v1.0.39 on macOS

Feel free to ignore if none of these address your specific case.

[rekram1-node]

I don't use iterm normally but I can't replicate...

Do u have any special custom themes or anything?

[wolfie82]

I was able to run the issue down.

Root Cause: Silent Plugin Initialization Failure in OpenCode v1.0.47+

The Breaking Change
Commit 4bb7ea9 (Nov 8, 2025) - "improve startup speed" changed how OpenCode initializes plugins:

Before (v1.0.46):
const cache = new Map<string, Context>()

• Plugins initialized AFTER instance setup was complete
• Errors during plugin init were visible/recoverable

After (v1.0.47+):
const cache = new Map<string, Promise>()

• Plugins initialized INSIDE a cached Promise
• If ANY plugin throws/hangs during init, entire Promise fails
• OpenCode shows black screen with NO error messages

What Caused the Failure

export const DynamicContextLoaderPlugin: Plugin = async ({ client, ... }) => {
  await client.app.log({  // ← THIS LINE FAILED
    body: {
      service: 'dynamic-context-loader',
      level: 'info',
      message: `🔌 Plugin initialized`,
    },
  })
  return { ... }
}

Why await client.app.log() failed during init:

• The OpenCode app/server wasn't fully ready yet during plugin initialization
• The client.app.log() call either threw an error or hung waiting for a response
• Since this happened inside the cached Promise, OpenCode failed silently
• Result: Black screen, no error messages, no way to debug

The Fix

Don't use await client.app.log() (or any async calls to client) during plugin initialization:

export const DynamicContextLoaderPlugin: Plugin = async ({ client, ... }) => {
  // Just initialize and return immediately - no await calls
  const manager = ContextLoaderManager.getInstance(projectPath)
  
  return {
    // Logging works fine HERE (after initialization)
    event: async ({ event }) => {
      await client.app.log({ ... })  // ✅ This is fine
    }
  }
}

[rekram1-node]

nice job tracking it down we will fix this