Desktop 1.4.6 on macOS gets stuck on loading screen; sidecar reaches server ready but UI never leaves loading.html #22791

Summary

On macOS, the OpenCode desktop app launches successfully, the sidecar reaches server ready, but the UI never leaves loading.html. The app stays stuck on the loading screen indefinitely.

This reproduces even after deleting all local OpenCode app data and config.

Version

• OpenCode Desktop 1.4.6
• macOS Tahoe 26.4.1
• Apple Silicon (arm64)

What I observed

• OpenCode.app starts normally
• main process, renderer process, GPU process, and sidecar all start
• the local sidecar port is listening and responding
• app log shows:

app starting
spawning sidecar
sidecar connection started
awaiting server ready
server ready

• but the renderer remains on:

file:///Applications/OpenCode.app/Contents/Resources/app.asar/out/renderer/loading.html

• expected local DB file is never created:

~/Library/Application Support/ai.opencode.desktop/opencode/opencode.db

Steps to reproduce

1. Install OpenCode Desktop 1.4.6 on macOS.
2. Launch the app for the first time.
3. Observe that the UI stays on the loading screen and never reaches the main app.

Additional debugging

I checked the packaged app startup flow and it looks like the app enters the needsMigration path when opencode.db is missing, opens loading.html, and waits for the loading flow to complete before showing the main window.

In my case:

• server ready is reached
• opencode.db is still not created
• the renderer remains on loading.html

I also fully removed local state and retried:

• ~/Library/Application Support/ai.opencode.desktop
• ~/.config/opencode
• ~/.local/share/opencode
• ~/Library/Logs/OpenCode
• ~/Library/Preferences/ai.opencode.desktop.plist

After a clean restart, the issue still reproduces in the same way.

Logs

Main log excerpt:

[2026-04-16 17:00:27.857] [info]  app starting { version: 1.4.6, packaged: true }
[2026-04-16 17:00:27.897] [info]  spawning sidecar { url: http://127.0.0.1:60350 }
[2026-04-16 17:00:28.241] [info]  sidecar connection started { url: http://127.0.0.1:60350 }
[2026-04-16 17:00:29.375] [info]  awaiting server ready
[2026-04-16 17:00:29.375] [info]  server ready { url: http://127.0.0.1:60350 }

One sidecar log attempt emitted only repeated:

ERROR service=server error= failed

Expected behavior

After first launch, the app should complete initialization / migration, create its local DB if needed, and transition from loading.html to the main app window.

Actual behavior

The app stays stuck on the loading screen indefinitely.