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