Skip to content

docs: point README install methods at V2 - #56839

Merged
rekram1-node merged 2 commits into
devfrom
v2-install-docs
Oct 18, 2026
Merged

rekram1-node merged 2 commits into
devfrom
v2-install-docs

Conversation

@rekram1-node

@rekram1-node rekram1-node commented Oct 18, 2026 •

Copy link
Copy Markdown
Contributor

Refs #54084

Problem

Several install commands in the README, and in all of its translations, install OpenCode 1. On a machine that already has V2, running one of them replaces it with V1. The curl script is the case reported in #54084. GitHub Releases, the Scoop and Chocolatey packages, the old tap formula, opencode-bin and nixpkgs also still ship V1.

Change

I checked what each README entry installs today and pointed every V1 entry at its V2 equivalent. Where no V2 version exists, I removed the entry.

README entry Installs today Change
curl … opencode.ai/install 1.19.3 → opencode.ai/v2/install (2.0.32)
npm i -g @opencode/cli@latest 2.0.32 keep
scoop install opencode 1.19.3 (Scoop Main bucket) remove: no V2 Scoop package
choco install opencode 1.19.1 (community package) remove: no V2 Chocolatey package
brew install anomalyco/tap/opencode 1.19.3 → anomalyco/tap/opencode-v2 (2.0.32)
brew install opencode (homebrew-core) 2.0.32 keep
sudo pacman -S opencode (extra) 2.0.32 keep
paru -S opencode-bin 1.19.3 → opencode-beta (2.0.32, our AUR package)
mise use -g opencode 2.0.32 (npm:@opencode/cli, min 2.0.0) keep
nix run nixpkgs#opencode 1.19.3 → nix run github:anomalyco/opencode (flake on dev, builds V2)
brew install --cask opencode-desktop 2.0.32 keep
scoop install extras/opencode-desktop 1.19.3 remove
Desktop link to "releases page" GitHub Releases latest is v1.19.3 remove; keep opencode.ai/download (V2)
Desktop table opencode-desktop-windows-x64.exe asset doesn't exist → opencode-desktop-win-x64.exe

These choices match the V2 docs, which use opencode-v2, opencode-beta and mise, and say that Windows package managers aren't supported.

Translations keep their existing wording. The rewritten desktop sentence drops only the releases-page link.

Out of scope

  • The "Installation Directory" section is unchanged apart from the curl URL. Support for OPENCODE_INSTALL_DIR and XDG_BIN_DIR was never ported to the V2 installer; that gap is separate from this PR.
  • The V1 docs site (packages/web) and the downgrade behavior of the legacy /install script.

Verification

  • Checked the current version of every package against its registry: npm, Homebrew API, anomalyco/homebrew-tap, Scoop Main/Extras, Chocolatey, the AUR RPC, the Arch package search, nixpkgs master, the mise registry and GitHub Releases.
  • rg 'opencode\.ai/install|scoop|choco|nixpkgs|opencode-bin|anomalyco/opencode/releases|windows-x64' README*.md → no matches

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Docs-only change that looks good. I checked the new install block in all 22 READMEs against the V2 install methods in services/www/src/docs/content/index.mdx, and they match. A search for the old install URL, opencode-ai, the desktop cask/Scoop snippet, Nix and the old install-dir variables finds nothing. The edit is the same (+4/−31) in every translation. Removing the "Installation Directory" section is correct: the repo's install script hardcodes $HOME/.opencode/bin.

Public API: unchanged.

No blocking concerns. One small, optional point: the unchanged npm i -g @opencode/cli@latest # or bun/pnpm/yarn line hides that bun needs --trust and pnpm needs --allow-build (as the V2 docs show) for the platform binary's postinstall script to run.

#52609 is an open pull request that does the same README work for README.md only, so it overlaps with this one.

Fixes #43772

@rekram1-node rekram1-node changed the title docs: point READMEs at V2 install methods docs: point README curl installs at V2 installer Oct 18, 2026
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