Repository navigation
docs: point README install methods at V2 - #56839
Conversation
There was a problem hiding this comment.
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
ec545c3 to
2afd4e5
Compare
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-binand 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.
curl … opencode.ai/installopencode.ai/v2/install(2.0.32)npm i -g @opencode/cli@latestscoop install opencodechoco install opencodebrew install anomalyco/tap/opencodeanomalyco/tap/opencode-v2(2.0.32)brew install opencode(homebrew-core)sudo pacman -S opencode(extra)paru -S opencode-binopencode-beta(2.0.32, our AUR package)mise use -g opencodenpm:@opencode/cli, min 2.0.0)nix run nixpkgs#opencodenix run github:anomalyco/opencode(flake ondev, builds V2)brew install --cask opencode-desktopscoop install extras/opencode-desktopopencode.ai/download(V2)opencode-desktop-windows-x64.exeopencode-desktop-win-x64.exeThese choices match the V2 docs, which use
opencode-v2,opencode-betaand 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
OPENCODE_INSTALL_DIRandXDG_BIN_DIRwas never ported to the V2 installer; that gap is separate from this PR.packages/web) and the downgrade behavior of the legacy/installscript.Verification
anomalyco/homebrew-tap, Scoop Main/Extras, Chocolatey, the AUR RPC, the Arch package search, nixpkgsmaster, the mise registry and GitHub Releases.rg 'opencode\.ai/install|scoop|choco|nixpkgs|opencode-bin|anomalyco/opencode/releases|windows-x64' README*.md→ no matches