OpenCode 中文教程

English

简体中文

English

简体中文

Appearance

v1.1.17: Desktop App Integration and Homebrew Upgrade Fix ​

Release Date: January 13, 2026

One-Line Summary ​

This update fixes the Homebrew auto-upgrade feature and greatly improves desktop app and CLI integration experience.

New Feature: Desktop App Auto-Manages CLI ​

What's Updated? ​

The desktop app can now automatically manage OpenCode CLI process, avoiding conflicts and duplicate startups.

What Are the Benefits? ​

Previous issues:

  • On macOS, opening desktop app and CLI simultaneously might conflict
  • Needed to manually close CLI to start desktop app

Now:

  • Desktop app automatically closes old CLI process on startup
  • CLI and desktop app share authentication, no need to login twice
  • Windows implements lifecycle management through JobObject

How to Use? ​

Just use desktop app normally, no extra configuration needed:

  1. Open desktop app
  2. App automatically handles CLI process
  3. Start working

Bug Fix: Homebrew Auto-Upgrade ​

Previous Issue ​

After installing OpenCode via Homebrew, running brew upgrade couldn't auto-update to latest version.

Current Behavior ​

Homebrew auto-upgrade feature fixed, now you can update via:

bash
# Auto-update all packages (including OpenCode)
brew upgrade

# Or update only OpenCode
brew upgrade opencode

Should You Upgrade? ​

SituationRecommendation
Installed via Homebrew✅ Upgrade (fixes auto-upgrade)
Using desktop app✅ Upgrade (improved integration experience)
Only using TUI, not HomebrewCan wait for next time

Upgrade Command:

bash
opencode upgrade

Technical Details (Skippable) ​

Click to expand full changelog

Core ​

  • Remove symlinkBinary function that replaces wrapper script
  • Fix Homebrew auto-upgrade feature

TUI ​

  • Prevent problem tool shortcuts from triggering when dialog is open

Desktop ​

  • Automatically close existing OpenCode CLI process when launching desktop app on macOS
  • Set serverPassword in desktop app
  • Provide PTY socket authentication from desktop app (if available)
  • Bind desktop app and CLI to same Windows JobObject

Community Contributors ​

  • @zerone0x: Fix problem tool shortcuts when dialog is open
  • @Brendonovich: Multiple desktop app integration improvements
  • @OpeOginni: Optimize filter list implementation

← Back to Changelog