Opencode beomces stuck on start if internet connection is not stable #3449

Closed
opened 2026-02-16 17:40:07 -05:00 by yindo · 7 comments
Owner

Originally created by @tamirzb on GitHub (Dec 10, 2025).

Originally assigned to: @rekram1-node on GitHub.

Description

As far as I understand when you start opencode it tries to download some stuff. When this happens it is still showing a blank screen before the opencode screen.

My internet connection is not very stable, some times I have a few seconds without a connection. When I try to run opencode there is a high chance that due to the unstable connection it will just get stuck in this loading state with a blank screen. After getting stuck nothing happens, no error message or anything like that. Also, Ctrl+C does not work, the only way to close it in that state is through kill.

OpenCode version

1.0.143

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

Arch Linux

Terminal

Alacritty

Originally created by @tamirzb on GitHub (Dec 10, 2025). Originally assigned to: @rekram1-node on GitHub. ### Description As far as I understand when you start opencode it tries to download some stuff. When this happens it is still showing a blank screen before the opencode screen. My internet connection is not very stable, some times I have a few seconds without a connection. When I try to run opencode there is a high chance that due to the unstable connection it will just get stuck in this loading state with a blank screen. After getting stuck nothing happens, no error message or anything like that. Also, Ctrl+C does not work, the only way to close it in that state is through `kill`. ### OpenCode version 1.0.143 ### Steps to reproduce _No response_ ### Screenshot and/or share link _No response_ ### Operating System Arch Linux ### Terminal Alacritty
yindo added the bug label 2026-02-16 17:40:07 -05:00
yindo closed this issue 2026-02-16 17:40:07 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Dec 10, 2025):

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

  • #5237: opencode web mode broken: empty page - multiple versions and multiple os
  • #4492: The opencode crash when the network is unstable
  • #5094: OpenCode TUI loses connection with server
  • #3273: MCP client failing makes opencode hang
  • #4823: v1.0.119: nothing to see in an environment with a proxy

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

@github-actions[bot] commented on GitHub (Dec 10, 2025): This issue might be a duplicate of existing issues. Please check: - #5237: opencode web mode broken: empty page - multiple versions and multiple os - #4492: The opencode crash when the network is unstable - #5094: OpenCode TUI loses connection with server - #3273: MCP client failing makes `opencode` hang - #4823: v1.0.119: nothing to see in an environment with a proxy Feel free to ignore if none of these address your specific case.
Author
Owner

@rekram1-node commented on GitHub (Dec 10, 2025):

what if you set OPENCODE_DISABLE_DEFAULT_PLUGINS=1

@rekram1-node commented on GitHub (Dec 10, 2025): what if you set OPENCODE_DISABLE_DEFAULT_PLUGINS=1
Author
Owner

@ariane-emory commented on GitHub (Dec 10, 2025):

This could be related to the models.dev refresh that happens during startup, maybe?

@ariane-emory commented on GitHub (Dec 10, 2025): This could be related to the models.dev refresh that happens during startup, maybe?
Author
Owner

@rekram1-node commented on GitHub (Dec 10, 2025):

it shouldn't be blocking tho, if it is that's a bug

@rekram1-node commented on GitHub (Dec 10, 2025): it shouldn't be blocking tho, if it is that's a bug
Author
Owner

@cmdrrobin commented on GitHub (Dec 11, 2025):

encounter same issues here. I'm still waiting for opencode to start. Only see a blank screen.

UPDATE: when I set OPENCODE_DISABLE_DEFAULT_PLUGINS=1 as @rekram1-node suggested, it starts fine.

@cmdrrobin commented on GitHub (Dec 11, 2025): encounter same issues here. I'm still waiting for opencode to start. Only see a blank screen. UPDATE: when I set `OPENCODE_DISABLE_DEFAULT_PLUGINS=1` as @rekram1-node suggested, it starts fine.
Author
Owner

@kenryu42 commented on GitHub (Jan 15, 2026):

@rekram1-node
I am facing the exact same issue in version 1.1.23. Tried reinstall, clear all caches and nuke all plugins. Even with no opencode.json config file.

OPENCODE_DISABLE_DEFAULT_PLUGINS=1 opencode does solve the problem but now I cannot start with just opencode.

@kenryu42 commented on GitHub (Jan 15, 2026): @rekram1-node I am facing the exact same issue in version `1.1.23`. Tried reinstall, clear all caches and nuke all plugins. Even with no `opencode.json` config file. `OPENCODE_DISABLE_DEFAULT_PLUGINS=1 opencode` does solve the problem but now I cannot start with just `opencode`.
Author
Owner

@kenryu42 commented on GitHub (Jan 16, 2026):

@rekram1-node I am facing the exact same issue in version 1.1.23. Tried reinstall, clear all caches and nuke all plugins. Even with no opencode.json config file.

OPENCODE_DISABLE_DEFAULT_PLUGINS=1 opencode does solve the problem but now I cannot start with just opencode.

Opened #8815 to fix this. The issue is that package.json can still reference a plugin even when its module directory is missing, causing the hang on reinstall check.

@kenryu42 commented on GitHub (Jan 16, 2026): > [@rekram1-node](https://github.com/rekram1-node) I am facing the exact same issue in version `1.1.23`. Tried reinstall, clear all caches and nuke all plugins. Even with no `opencode.json` config file. > > `OPENCODE_DISABLE_DEFAULT_PLUGINS=1 opencode` does solve the problem but now I cannot start with just `opencode`. Opened #8815 to fix this. The issue is that `package.json` can still reference a plugin even when its module directory is missing, causing the hang on reinstall check.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3449