Skip to content

Conversation

@ryoppippi
Copy link

@ryoppippi ryoppippi commented Jan 19, 2026

do you know this secret

Summary by CodeRabbit

  • Documentation
    • Updated Node.js requirement to optional for opencode users
    • Added quick start instructions for running with opencode
    • Streamlined setup guide with multiple installation methods available

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai
Copy link

coderabbitai bot commented Jan 19, 2026

📝 Walkthrough

Walkthrough

Updated README.md to make Node.js optional and add opencode installation instructions. The change clarifies that Node.js is not required when using opencode, while preserving existing npm and git-based installation methods.

Changes

Cohort / File(s)
Documentation
README.md
Made Node.js requirement optional with clarification for opencode users; added BUN_BE_BUN=1 opencode command; retained existing npm and git installation methods

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 Hop along with opencode, no Node to install,
Optional and nimble, we've answered the call!
New paths to run scripts, both swift and quite free,
The README's dancing, as happy as we! 🌟

🚥 Pre-merge checks | ✅ 2 | ❌ 1
❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'docs: BUN_BE_BUN' is vague and cryptic. While it references a real component (an environment variable) in the changeset, it does not clearly communicate the primary purpose of the changes, which is to document optional Node.js requirements and new opencode workflow instructions. Consider using a more descriptive title that clarifies the main change, such as 'docs: Add opencode quick start and make Node.js optional' or 'docs: Document BUN_BE_BUN environment variable and opencode installation method'.
✅ Passed checks (2 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
  • 📝 Generate docstrings

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ryoppippi ryoppippi changed the title docs: bu_bun docs: BUN_BE_BUN Jan 19, 2026
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@README.md`:
- Around line 25-27: Update the README note to remove the incorrect "no need
node/bun" claim and clearly state that Node.js (>=18.0.0) is
required/recommended for npm/pnpm/yarn installs and that Bun is a
supported/recommended alternative; clarify that the BUN_BE_BUN=1 env var is used
for Bun runtime detection in compiled binaries (not to eliminate Node/Bun
requirements). Also verify the command "opencode x cursor-opencode-auth" (or
replace it) by either documenting its usage/syntax or substituting a documented
install/run example (e.g., npm/pnpm/yarn or officially supported opencode
invocation) so users have a supported, documented command to follow.

Comment on lines +25 to +27
# Or run with opencode (no need node/bun)
BUN_BE_BUN=1 opencode x cursor-opencode-auth

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🌐 Web query:

opencode BUN_BE_BUN environment variable documentation

💡 Result:

Short answer — BUN_BE_BUN is a Bun runtime environment variable that, when set (usually to "1"), makes a single-file executable produced by bun build --compile behave like the bun CLI (runs Bun itself / exposes Bun commands instead of the embedded app). OpenCode’s code/tooling may set or check BUN_BE_BUN for Bun detection. Sources: Bun docs/blog (executable behavior) [1][2]; OpenCode environment list / repo notes (mentions BUN_BE_BUN set by bash tool for detection) [3][4].

Sources

  1. Bun docs — Single-file executable / Act as the Bun CLI.
  2. Bun blog / release notes describing BUN_BE_BUN.
  3. OpenCode CLI docs — environment variables list.
  4. OpenCode product spec / repo gist mentioning BUN_BE_BUN detection.

🌐 Web query:

opencode x cursor command syntax

💡 Result:

Use the Cursor CLI as your EDITOR and call OpenCode’s editor commands. Example steps:

  • Install Cursor CLI (adds the cursor command). [1]
  • Set EDITOR to Cursor with wait flag: export EDITOR="cursor --wait". [2][1]
  • From the OpenCode TUI run the editor command (or use /editor): OpenCode will launch Cursor. Or run opencode in a terminal and use the editor keybinding/command. [2][3]

Example commands:

  • Install/confirm cursor CLI per Cursor docs. [1]
  • Set editor (Linux/macOS): export EDITOR="cursor --wait". [2]
  • In TUI: /editor (or press the editor keybind) to open the file in Cursor. [2][3]

Sources:
[1] Cursor CLI docs.
[2] OpenCode TUI / Editor setup docs.
[3] OpenCode keybinds / editor integration docs.


🌐 Web query:

opencode tool requirements Node.js Bun

💡 Result:

Short answer — requirements and install options for OpenCode:

  • Node.js: recommended/required Node.js ≥ 18.0.0 for npm/pnpm/yarn installs. [1][2]
  • Bun: supported (often recommended for web/UI examples); Bun can be used to install/run packages and dev servers. [2][3]
  • No heavy runtime beyond a modern terminal; OpenCode itself is a CLI (native binary/Go-built CLI published by the project) but distribution/install wrappers are provided via curl|bash, npm/pnpm/yarn, bun, Homebrew, paru (Arch), and Windows package managers (choco/winget/scoop). [1][2][4]
  • Other basics: Git (for cloning), optional Docker for sandboxing, and API keys for any LLM providers you intend to use. [1][5]

Install entry points (examples): curl -fsSL https://opencode.ai/install | bash; npm install -g opencode-ai; bun install -g opencode-ai; brew/paru/choco/winget/scoop options. [1][2][4]

Sources: OpenCode docs/site and GitHub.
[1] https://dev.opencode.ai/ › (site)
[2] https://github.com/opencode-ai/opencode
[3] Example repo mentioning Bun recommended: https://github.com/chris-tse/opencode-web
[4] Install docs & package-manager options: https://opencode.ai/docs/ and related install pages
[5] Prereqs (Git, Docker, API keys): https://dev.opencode.ai/docs/


Incorrect dependency claim: Node.js IS required/recommended, not optional.

The line "no need node/bun" contradicts OpenCode's documented requirements. Node.js ≥ 18.0.0 is required/recommended for installation via npm/pnpm/yarn, and Bun is a supported and recommended option, not something you skip. The BUN_BE_BUN=1 environment variable is for Bun runtime detection in compiled binaries, not for eliminating Bun as a runtime option.

Correct the note to accurately reflect installation requirements. Additionally, the specific command opencode x cursor-opencode-auth lacks public documentation—verify its syntax and provide context for users unfamiliar with this invocation.

🤖 Prompt for AI Agents
In `@README.md` around lines 25 - 27, Update the README note to remove the
incorrect "no need node/bun" claim and clearly state that Node.js (>=18.0.0) is
required/recommended for npm/pnpm/yarn installs and that Bun is a
supported/recommended alternative; clarify that the BUN_BE_BUN=1 env var is used
for Bun runtime detection in compiled binaries (not to eliminate Node/Bun
requirements). Also verify the command "opencode x cursor-opencode-auth" (or
replace it) by either documenting its usage/syntax or substituting a documented
install/run example (e.g., npm/pnpm/yarn or officially supported opencode
invocation) so users have a supported, documented command to follow.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant