opencode get stuck when `bun add` get stuck

[WAY29]

Description

What happen:
When I executed opencode, the program froze, akin to a terminal being frozen. I was unable to close it using any method, such as pressing Ctrl+C. When I terminated it from another terminal, I ran it again with the --print-log option and noticed it was stuck at the bun add command. I think we should improve this situation.

I've done some digging and found out why the bun got stuck. It's because my bun encountered a 304 response, and then it just went nowhere. Maybe we should add --no-cache option when run bun.

By the way, I've encountered this error multiple times already; I often have to manually run "bun add."

bun add --cwd /Users/lang/.cache/opencode --force --exact opencode-anthropic-auth@0.0.2 --verbose

bun add v1.3.3 (274e01c7)
   - "opencode-anthropic-auth": "0.0.2" - opencode-anthropic-auth@0.0.2
Enqueue package manifest for download: @openauthjs/openauth
  🔍 Resolving [1/1] [fetch] > HTTP/1.1 GET https://registry.npmmirror.com/@openauthjs%2fopenauth
[fetch] > If-None-Match: W/"e9e873cea576887a9d66bdd1048dbf983cadbe45"
[fetch] > Accept: application/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8, */*
[fetch] > Connection: keep-alive
[fetch] > User-Agent: Bun/1.3.3
[fetch] > Host: registry.npmmirror.com
[fetch] > Accept-Encoding: gzip, deflate, br, zstd

[fetch] < 200 Connection established

[fetch] < 304 Not Modified
[fetch] < Server: Tengine
[fetch] < Connection: keep-alive
[fetch] < Strict-Transport-Security: max-age=5184000
[fetch] < Date: Mon, 24 Nov 2025 08:21:49 GMT
[fetch] < request-id: cb00ed85-d034-4a21-b240-036edd52697a
[fetch] < cache-control: public, max-age=300
[fetch] < x-frame-options: SAMEORIGIN
[fetch] < x-xss-protection: 1; mode=block
[fetch] < x-content-type-options: nosniff
[fetch] < x-download-options: noopen
[fetch] < x-readtime: 1.462
[fetch] < Via: cn8360.l1, kunlun1.cn8360, l2cn8047.l2, cache23.l2cn8047, npmmirror-x86-20220823001, cache23.l2cn8047[0,0,304-0,H], cache34.l2cn8047[1,0], kunlun10.cn7632[32,31,304-0,H], kunlun1.cn7632[34,0]
[fetch] < Vary: Origin, Accept, Accept-Encoding
[fetch] < etag: W/"e9e873cea576887a9d66bdd1048dbf983cadbe45"
[fetch] < Age: 45
[fetch] < Ali-Swift-Global-Savetime: 1763972509
[fetch] < X-Cache: HIT TCP_REFRESH_HIT dirn:-2:-2
[fetch] < X-Swift-SaveTime: Mon, 24 Nov 2025 08:22:34 GMT
[fetch] < X-Swift-CacheTime: 255
[fetch] < Timing-Allow-Origin: *
[fetch] < EagleId: 2493171517639725549608795e

OpenCode version

No response

Steps to reproduce

1. run opencode
2. get stuck

Screenshot and/or share link

No response

Operating System

macos

Terminal

vscode terminal

[github-actions]

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

• OpenCode Github Agent Stuck! #4672: OpenCode Github Agent Stuck! - Reports OpenCode getting stuck during execution

The root cause you've identified (bun hanging on 304 cache responses) appears to be specific to this issue, but the symptom (OpenCode freezing/getting stuck) is also seen in #4672. Feel free to ignore if your specific case differs from those issues.

[WAY29]

Is there a way to prevent opencode from updating bun depends anymore?

[rekram1-node]

hmm ill look into it, for this the only work around would be to disable the default plugins that we load (or only work around we currently provide)

[jensenojs]

Regarding this issue, I'd like to add another common case: for users in mainland China, updating bun may require configuring a mirror.

https://bun.com/docs/runtime/bunfig

[install]
registry = "https://registry.npmmirror.com"

Although I'm not sure whether this information is appropriate, or where it should be mentioned @rekram1-node

[WAY29]

Regarding this issue, I'd like to add another common case: for users in mainland China, updating bun may require configuring a mirror.

https://bun.com/docs/runtime/bunfig

[install]
registry = "https://registry.npmmirror.com"
Although I'm not sure whether this information is appropriate, or where it should be mentioned @rekram1-node

Yes, I am Chinese, I had already add bun mirror, but bun still got stuck when http response 304 status code

[rekram1-node]

that's good to know thx

[jslorrma]

I'm facing exactly the same issue and therefore cannot use Opencode right now. Is there any temp. workaround to get it working again?

For context, I'm not located in China, but within a corporate network and behind a corporate proxy. I have proxies configured via environment variables (HTTP_PROXY, HTTPS_PROXY) and by setting them in npm config using npm config set proxy ... and npm config set https-proxy ....

[driden]

Hey everyone, just wanted to +1 this since I'm having the same issue when opencode goes through the bootstrapping routine.

INFO  2025-12-02T14:47:40 +166ms service=server method=GET path=/ request
INFO  2025-12-02T14:47:40 +0ms service=server status=started method=GET path=/ request
INFO  2025-12-02T14:47:40 +1ms service=default directory=/Users/user/.config/opencode creating instance
INFO  2025-12-02T14:47:40 +0ms service=project directory=/Users/user/.config/opencode fromDirectory
INFO  2025-12-02T14:47:40 +2ms service=default directory=/Users/user/.config/opencode bootstrapping
INFO  2025-12-02T14:47:40 +2ms service=config path=/Users/user/.config/opencode/config.json loading
INFO  2025-12-02T14:47:40 +0ms service=config path=/Users/user/.config/opencode/opencode.json loading
INFO  2025-12-02T14:47:40 +2ms service=config path=/Users/user/.config/opencode/opencode.jsonc loading
INFO  2025-12-02T14:47:40 +1ms service=config path=/Users/user/.config/opencode/opencode.json loading
INFO  2025-12-02T14:47:40 +2ms service=bun cmd=["/opt/homebrew/Cellar/opencode/1.0.126/libexec/lib/node_modules/opencode-ai/node_modules/opencode-darwin-arm64/bin/opencode","add","@opencode-ai/plugin@1.0.126","--exact"] cwd=/Users/user/.config/opencode running

edit: It seems that after many attempts of launching & having to kill opencode it finally managed to install the dependency and it started working again.

[rekram1-node]

There is a known issue w/ proxy stuff Ill get it fixed soon

[WAY29]

Once again, I encountered this problem, and for some reason, the dependencies of opencode I installed disappeared. I then used bun to install opencode again, and I got stuck in bun once more.

[WAY29]

Once again, I encountered this problem, and for some reason, the dependencies of opencode I installed disappeared. I then used bun to install opencode again, and I got stuck in bun once more.

oven-sh/bun#11526
This issue may be somewhat helpful; currently, it seems that the only way to help is for users to disable ipv6 or add —no-cache when adding bun (this appears to be the simplest solution).

[jensenojs]

repo because of opencode-dcp

INFO  2025-12-05T09:06:31 +2ms service=server status=started method=GET path=/event request
INFO  2025-12-05T09:08:27 +115632ms service=bun code=0 stdout=bun add v1.3.3 (274e01c7)

installed @tarquinen/opencode-dcp@0.4.2

115 packages installed [721.63s]
 stderr=Resolving dependencies
Resolved, downloaded and extracted [71]
Saved lockfile
 done
INFO  2025-12-05T09:08:27 +96ms service=plugin path=file:///Users/oujinsai/.config/opencode/plugin/notification.js loading plugin
INFO  2025-12-05T09:08:27 +1ms service=plugin path=file:///Users/oujinsai/.config/opencode/plugin/env-protection.js loading plugin
INFO  2025-12-05T09:08:27 +0ms service=plugin path=opencode-copilot-auth@0.0.8 loading plugin
INFO  2025-12-05T09:08:27 +2ms service=bun pkg=opencode-copilot-auth version=0.0.8 installing package using Bun's default registry resolution
INFO  2025-12-05T09:08:27 +0ms service=bun pkg=opencode-copilot-auth version=0.0.8 attempt=1 total=3 bun install attempt
INFO  2025-12-05T09:08:27 +0ms service=bun cmd=["/opt/homebrew/Cellar/opencode/1.0.133/bin/opencode","add","--force","--exact","--cwd","/Users/oujinsai/.cache/opencode","opencode-copilot-auth@0.0.8"] cwd=/Users/oujinsai/.cache/opencode running
INFO  2025-12-05T09:10:28 +120663ms service=bun code=0 stdout=bun add v1.3.3 (274e01c7)

+ @tarquinen/opencode-dcp@0.4.2

installed opencode-copilot-auth@0.0.8

116 packages installed [120.65s]
 stderr=Resolving dependencies
Resolved, downloaded and extracted [5]
Saved lockfile
 done
INFO  2025-12-05T09:10:28 +38ms service=plugin path=opencode-anthropic-auth@0.0.4 loading plugin
INFO  2025-12-05T09:10:28 +5ms service=bun pkg=opencode-anthropic-auth version=0.0.4 installing package using Bun's default registry resolution
INFO  2025-12-05T09:10:28 +0ms service=bun pkg=opencode-anthropic-auth version=0.0.4 attempt=1 total=3 bun install attempt
INFO  2025-12-05T09:10:28 +0ms service=bun cmd=["/opt/homebrew/Cellar/opencode/1.0.133/bin/opencode","add","--force","--exact","--cwd","/Users/oujinsai/.cache/opencode","opencode-anthropic-auth@0.0.4"] cwd=/Users/oujinsai/.cache/opencode running
...

[WAY29]

Once again, I've encountered this issue. It seems that after every auto-update of opencode, the bun dependency gets deleted, leading to this problem cropping up after each auto-update: opencode-anthropic-auth@0.0.4.