Skip to main content

Update OCX

Prerelease builds follow npm’s next channel. Updates cannot cross major versions. No automatic update check runs after ordinary OCX commands. For a source checkout, update the checkout you intend to test and rebuild the CLI. Do not use self-update as a way to select an arbitrary branch. The frozen OCX 2.0.15 line remains the client for OpenCode V1.

Uninstall OCX

Preview before removing an installation:
The preview identifies the managed configuration and executable affected by the detected installation method. Running without --dry-run performs removal; there is no additional confirmation flag. Self-uninstall targets the new OCX storage root, including named profiles. It preserves native OpenCode configuration/data and legacy OCX profiles under the old opencode/profiles/ location. It also leaves project-installed files in individual repositories. For package-manager installations, OCX reports the package-manager command needed to remove the package itself. A required manual package-manager step returns exit code 1; read the output rather than treating it as completed removal. Safety checks return exit code 2 for unsafe paths such as a symlinked managed root. The command supports only --dry-run and --json. Back up profiles you want to keep before an actual uninstall. To remove one profile instead, use profile removal.

OpenCode itself

These commands manage OCX, not the OpenCode executable or its service. Follow the native CLI documentation for OpenCode upgrades and removal.