Repository navigation
fix(desktop): health check fails during server startup causing IDE instability #24142
Closed as not planned
Description
Pre-flight Checks
- I have searched existing issues and this is not a duplicate
- I understand this issue needs status:approved before a PR can be opened
Bug Description
The desktop app health check does not retry when the local server sidecar is still initializing. This causes:
- MCP local connections to repeatedly disconnect and reconnect
- IDE freezes when switching between sessions
- Server marked as unhealthy even though it is still starting up
Steps to Reproduce
- Open OpenCode desktop app
- Server sidecar starts but health check fires immediately
- Health check fails because server is not ready yet
- Desktop app shows server as down
- IDE becomes unresponsive or MCPs disconnect
Expected Behavior
Health check should retry with exponential backoff until the server is ready, up to a reasonable timeout.
Actual Behavior
Health check fails instantly on first attempt, causing cascading instability.
Operating System
Windows
Agent / Client
OpenCode Desktop
Shell
PowerShell
Relevant Logs
Server stdout shows "sidecar process spawned, waiting for server to become healthy" followed immediately by health check error without retries.
Additional Context
Related PR: #24138 which implements retry logic.
Metadata
Metadata
Assignees
Labels
No labels
Activity
github-actions commentedon Apr 24, 2026
This issue might be a duplicate of existing issues. Please check:
herjarsa commentedon Apr 24, 2026
This is not a duplicate. The related issues (#23734, #23308) describe symptoms (desktop freeze, stuck on loading) that share root causes with this, but this issue specifically identifies the missing retry logic as the source.
PR #24138 fixes this by adding exponential backoff to the health check system.
github-actions commentedon Jul 4, 2026
To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.