OpenCode Desktop App

OpenCode is available as a native desktop application with a graphical interface, providing the same powerful AI coding capabilities in a more user-friendly environment.

Download

Download the desktop app directly from our releases page or from opencode.ai/download.

Platform	Download
macOS (Apple Silicon)	opencode-desktop-darwin-aarch64.dmg
macOS (Intel)	opencode-desktop-darwin-x64.dmg
Windows	opencode-desktop-windows-x64.exe
Linux	.deb, .rpm, or AppImage

Package Manager Installation

macOS (Homebrew)

brew install --cask opencode-desktop

Windows (Scoop)

scoop bucket add extras
scoop install extras/opencode-desktop

Features

The desktop app provides all the features of the terminal version with additional benefits:

Graphical Interface

Native desktop window with familiar UI
Drag and drop file support
System tray integration
Keyboard shortcuts
Multiple window support

Session Management

Multiple concurrent sessions
Session history and bookmarks
Session sharing via links
Export session logs

Editor Integration

Built-in code editor with syntax highlighting
Diff viewer for code changes
File tree navigation
Quick file search

Authentication

All authentication methods available in the CLI are also available in the desktop app:

OpenCode Zen: Built-in free models
GitHub Copilot: Use your existing subscription
ChatGPT Plus/Pro: Direct integration
Custom API Keys: Configure any provider

Configuration

The desktop app stores its configuration in:

macOS: ~/Library/Application Support/opencode/
Windows: %APPDATA%\opencode\
Linux: ~/.config/opencode/

Settings File

Configuration is stored in config.json:

{
  "theme": "dark",
  "fontSize": 14,
  "model": "zen-default",
  "language": "en"
}

Keyboard Shortcuts

Action	Shortcut
New Session	`Cmd/Ctrl + N`
Open File	`Cmd/Ctrl + O`
Save	`Cmd/Ctrl + S`
Find	`Cmd/Ctrl + F`
Toggle Sidebar	`Cmd/Ctrl + B`
Settings	`Cmd/Ctrl + ,`
Quit	`Cmd/Ctrl + Q`

Auto-Update

The desktop app automatically checks for updates on launch. You can also manually check for updates:

macOS: OpenCode → Check for Updates...
Windows: Help → Check for Updates
Linux: Help → Check for Updates

Comparison with CLI

Feature	Desktop App	CLI
Graphical Interface	✅	❌
Multiple Sessions	✅	✅
Session Sharing	✅	✅
File Navigation	GUI	Terminal
Resource Usage	Higher	Lower
Automation/Scripting	Limited	✅
Remote Access	❌	✅

Troubleshooting

App Won’t Start

Check if another instance is already running
Verify system requirements (Node.js 18+)
Check firewall settings

Authentication Issues

Run opencode auth login from terminal first
Check API key validity
Verify network connectivity

Performance Issues

Reduce number of concurrent sessions
Clear session history
Check available system memory

Beta Status

The desktop app is currently in beta. While stable for daily use, you may encounter:

Occasional UI glitches
Feature changes between versions
Performance variations

We actively collect feedback to improve the desktop experience. Report issues on our GitHub Issues page.