Upgrades and repair
Upgrades and repair
Section titled “Upgrades and repair”One-step upgrade
Section titled “One-step upgrade”uc upThis runs the official opencode upgrade, updates UltraCode to its stable release, and applies configuration idempotently. OpenCode is upgraded only when you explicitly choose this command.
Official entry points remain valid
Section titled “Official entry points remain valid”opencode upgradecurl -fsSL https://opencode.ai/v2/install | bashThe official TUI /update also remains available. After using any of them:
uc syncThis restores missing files, merges new managed values, and repairs the private runtime.
Update only UltraCode
Section titled “Update only UltraCode”uc updateInspect
Section titled “Inspect”uc doctoropencode --versionDoctor performs structural checks only and makes no model call.
Compatibility
Section titled “Compatibility”OpenCode V2.3.x is the tested baseline. Newer V2 releases receive structural checks. New major versions or plugin contract changes require an explicit compatibility release; future compatibility is not assumed.
Recovery order
Section titled “Recovery order”Restore OpenCode through its official channel if needed, pin and sync UltraCode, then uninstall if necessary. Restore timestamped backups last so newer changes are not overwritten.