Skip to main content

​
Overview

The upgrade command updates OpenCode to the latest version or a specific target version. It automatically detects your installation method and uses the appropriate upgrade mechanism.

​
Usage

opencode upgrade [target]

​
Upgrade to Latest

opencode upgrade

​
Upgrade to Specific Version

opencode upgrade v0.1.48
# or
opencode upgrade 0.1.48

​
Options

​
target
string
Version to upgrade to (e.g., 0.1.48 or v0.1.48). If omitted, upgrades to the latest version.
​
--method
string
Installation method to use. Short form: -mSupported methods:
  • curl - Shell script installation
  • npm - Node Package Manager
  • pnpm - PNPM package manager
  • bun - Bun package manager
  • brew - Homebrew (macOS/Linux)
  • choco - Chocolatey (Windows)
  • scoop - Scoop (Windows)

​
Installation Methods

​
Automatic Detection

OpenCode automatically detects how it was installed: 
opencode upgrade
Output: 
Using method: npm
From 0.1.47 → 0.1.48
Upgrading...
✓ Upgrade complete

​
Manual Method

Override automatic detection: 
opencode upgrade --method brew

​
Examples

​
Update to Latest

$ opencode upgrade

  ___                   ___          _
 / _ \ _ __   ___ _ __ / ___|___   __| | ___
| | | | '_ \ / _ \ '_ \\ |   / _ \ / _` |/ _ \
| |_| | |_) |  __/ | | | |_| (_) | (_| |  __/
 \___/| .__/ \___|_| |_|\____\___/ \__,_|\___|
      |_|

◇ Upgrade

◇ Using method: npm
◇ From 0.1.47 → 0.1.48
◇ Upgrading...
✓ Upgrade complete

✓ Done

​
Specific Version

opencode upgrade v0.1.45

​
Force npm Method

opencode upgrade --method npm

​
Downgrade

You can also downgrade to an earlier version: 
opencode upgrade v0.1.40

​
Installation Method Details

​
curl (Shell Script)

For installations via the shell script: 
curl -fsSL https://opencode.ai/install.sh | sh
Upgrade: 
opencode upgrade --method curl
This re-downloads and installs the latest version.

​
npm/pnpm/bun

For Node.js package managers: 
npm install -g opencode
pnpm install -g opencode
bun install -g opencode
Upgrade: 
opencode upgrade --method npm
# or
opencode upgrade --method pnpm
# or
opencode upgrade --method bun
This runs the equivalent of npm update -g opencode.

​
brew (Homebrew)

For macOS and Linux Homebrew installations: 
brew install opencode
Upgrade: 
opencode upgrade --method brew
Runs brew upgrade opencode.

​
choco (Chocolatey)

For Windows Chocolatey: 
choco install opencode
Upgrade: 
opencode upgrade --method choco
Chocolatey requires an elevated (Administrator) command prompt for upgrades.

​
scoop (Scoop)

For Windows Scoop: 
scoop install opencode
Upgrade: 
opencode upgrade --method scoop

​
Version Detection

​
Check Current Version

opencode --version
Or: 
opencode -v

​
Already Up to Date

If you’re already on the target version: 
◇ opencode upgrade skipped: 0.1.48 is already installed
✓ Done

​
Troubleshooting

​
Unknown Installation Method

Problem: opencode is installed to /path/to/opencode and may be managed by a package manager Solutions:
  • Specify the method explicitly: opencode upgrade --method npm
  • Uninstall and reinstall using a supported method
  • Use your package manager directly
Prompt to install anyway: The command will ask if you want to proceed: 
◆ Install anyways?
│ ● Yes
│   No
└
Select “Yes” to install using the default method (curl).

​
Permission Denied

Problem: Permission errors during upgrade Solutions: macOS/Linux: 
sudo opencode upgrade
Windows (Chocolatey): Run Command Prompt or PowerShell as Administrator: 
opencode upgrade --method choco

​
Network Errors

Problem: Cannot download new version Solutions:
  • Check internet connectivity
  • Verify firewall allows downloads
  • Try again later (registry may be temporarily unavailable)
  • Check proxy settings if behind corporate firewall

​
Upgrade Failed

Problem: Generic upgrade failure Solutions:
  • Check stderr output for specific error
  • Try a different installation method
  • Manually uninstall and reinstall
  • Report the issue on GitHub

​
Cannot Find Version

Problem: Specified version doesn’t exist Solutions:
  • Check available versions on GitHub Releases
  • Verify version format (use v0.1.48 or 0.1.48)
  • Omit version to get latest: opencode upgrade

​
Automatic Updates

By default, OpenCode checks for updates and notifies you: 
! A new version (0.1.48) is available. Run `opencode upgrade` to update.

​
Disable Auto-Update Checks

Set environment variable: 
export OPENCODE_DISABLE_AUTOUPDATE=true
Or in opencode.json: 
{
  "disableAutoUpdate": true
}

​
Upgrade Strategies

​
Stable Releases

For production use: 
# Stay on latest stable
opencode upgrade

​
Specific Versions

For consistency across team: 
# Pin to specific version
opencode upgrade v0.1.48
Document the version in your project: 
// package.json or similar
{
  "opencode": "^0.1.48"
}

​
Testing New Releases

Test pre-release versions: 
# Try beta/rc versions
opencode upgrade v0.2.0-beta.1
Pre-release versions may have bugs. Don’t use in production.

​
Post-Upgrade

After upgrading:
  1. Verify version: 
    opencode --version
  2. Check release notes: Visit GitHub Releases for changelog
  3. Test functionality: 
    opencode --help
  4. Review breaking changes: Major version upgrades may have breaking changes

​
Manual Installation

If automatic upgrade fails, manually install:

​
Shell Script

curl -fsSL https://opencode.ai/install.sh | sh

​
npm

npm install -g opencode-ai@latest

​
Homebrew

brew upgrade opencode

​
From Source

git clone https://github.com/anomalyco/opencode.git
cd opencode
bun install
bun run build
bun link

Installation

Initial installation guide

Release Notes

View version changelogs

uninstall

Remove OpenCode completely

Troubleshooting

Resolve common issues

Build docs developers (and LLMs) love

Get started for freeTalk to us