OpenCode CLI Critical Runtime Failure #4841

Open
opened 2026-02-16 17:45:39 -05:00 by yindo · 1 comment
Owner

Originally created by @arnabclir on GitHub (Jan 12, 2026).

Originally assigned to: @rekram1-node on GitHub.

Description

Files:

opencode-installation-issue-report.md
opencode-fix-documentation.md
Summary: OpenCode v1.1.13 installation appears successful but the tool is completely non-functional due to Bun runtime virtual filesystem (bunfs) incompatibility with PRoot environments.

Key Issues:

UX Issue: Installation script doesn't update current shell PATH (easily worked around with source ~/.bashrc)
Critical Bug: Bun's bunfs cannot resolve module paths in PRoot, causing all core commands to fail
Error:

Error: Cannot find module '/home/arnab/.cache/opencode/node_modules/opencode-copilot-auth'
from '/$bunfs/root/src/index.js'
Working Commands: --version, --help, models, debug paths Broken Commands: run, stats, debug config (anything that loads plugins)

Severity: CRITICAL - Tool is completely unusable on this platform

Root Cause: Bun's virtual filesystem (bunfs) is incompatible with PRoot's user-space virtualization layer

Recommended Fixes:

Detect PRoot/container environments and use Node.js runtime instead of Bun
Disable bunfs via BUN_DISABLE_BUNFS=1 environment variable
Use absolute filesystem paths instead of Bun virtual paths
Add platform compatibility warnings at install time
Status: No user workaround available - Requires OpenCode team to implement PRoot compatibility

Plugins

No response

OpenCode version

No response

Steps to reproduce

  1. Just installed OpenCode

Screenshot and/or share link

No response

Operating System

proot distro in termux

Terminal

Termux

Originally created by @arnabclir on GitHub (Jan 12, 2026). Originally assigned to: @rekram1-node on GitHub. ### Description Files: [opencode-installation-issue-report.md](https://github.com/arnabclir/reports/blob/master/opencode-installation-issue-report.md) [opencode-fix-documentation.md](https://github.com/arnabclir/reports/blob/master/opencode-fix-documentation.md) Summary: OpenCode v1.1.13 installation appears successful but the tool is completely non-functional due to Bun runtime virtual filesystem (bunfs) incompatibility with PRoot environments. Key Issues: UX Issue: Installation script doesn't update current shell PATH (easily worked around with source ~/.bashrc) Critical Bug: Bun's bunfs cannot resolve module paths in PRoot, causing all core commands to fail Error: Error: Cannot find module '/home/arnab/.cache/opencode/node_modules/opencode-copilot-auth' from '/$bunfs/root/src/index.js' Working Commands: --version, --help, models, debug paths Broken Commands: run, stats, debug config (anything that loads plugins) Severity: CRITICAL - Tool is completely unusable on this platform Root Cause: Bun's virtual filesystem (bunfs) is incompatible with PRoot's user-space virtualization layer Recommended Fixes: Detect PRoot/container environments and use Node.js runtime instead of Bun Disable bunfs via BUN_DISABLE_BUNFS=1 environment variable Use absolute filesystem paths instead of Bun virtual paths Add platform compatibility warnings at install time Status: No user workaround available - Requires OpenCode team to implement PRoot compatibility ### Plugins _No response_ ### OpenCode version _No response_ ### Steps to reproduce 1. Just installed OpenCode ### Screenshot and/or share link _No response_ ### Operating System proot distro in termux ### Terminal Termux
yindo added the bug label 2026-02-16 17:45:39 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Jan 12, 2026):

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

  • #7843: [Critical] CLI hangs on second run (Deadlock) on Linux ARM64 (Proot/Container environments) - Reports identical Proot/ARM64 environment issues with CLI hangs on second run
  • #7472: OpenCode crashes with "Aborted" on Termux/Debian on second attempt - Reports crashes on second run in Termux/Proot environments
  • #3143: [Bug] Opencode crashes on second run in Termux/Proot distro - Reports crashes on subsequent runs in Proot distros
  • #6825: [FEATURE]:Provide a package without native binary, for running with nodejs - Feature request for Node.js runtime to avoid Bun/bunfs incompatibility in PRoot environments

Feel free to ignore if your specific case differs from these, but these issues address Bun runtime and Proot/Termux compatibility concerns.

@github-actions[bot] commented on GitHub (Jan 12, 2026): This issue might be a duplicate of existing issues. Please check: - #7843: [Critical] CLI hangs on second run (Deadlock) on Linux ARM64 (Proot/Container environments) - Reports identical Proot/ARM64 environment issues with CLI hangs on second run - #7472: OpenCode crashes with "Aborted" on Termux/Debian on second attempt - Reports crashes on second run in Termux/Proot environments - #3143: [Bug] Opencode crashes on second run in Termux/Proot distro - Reports crashes on subsequent runs in Proot distros - #6825: [FEATURE]:Provide a package without native binary, for running with nodejs - Feature request for Node.js runtime to avoid Bun/bunfs incompatibility in PRoot environments Feel free to ignore if your specific case differs from these, but these issues address Bun runtime and Proot/Termux compatibility concerns.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#4841