Skip to content

Repository files navigation

OpenCode Desktop

A cross-platform desktop app (macOS, Linux) that wraps opencode serve's web GUI using the Wizardry framework.

When launched, it starts opencode serve in the background, waits for the server to be ready, then hands the full native WebView over to the OpenCode web interface — no browser tab needed.

This app intentionally avoids embedding OpenCode in a nested iframe. Running the OpenCode UI as the top-level page preserves its own storage/session state and avoids WebKit third-party embedding glitches.

Usage

Make sure opencode is installed and available in your PATH, then run the app via the Wizardry runtime.

The app uses opencode serve --port 0 (random available port) by default.

Controls

Button Action
Open the web GUI in your default browser
Reload the embedded web GUI

Local LLM Setup

OpenCode itself does not manage local model installs. This repo includes a Wizardry-powered helper that bootstraps Wizardry if needed, shows the curated recommended local models, and then opens the interactive install/manage menu:

./tools/setup/install-local-llms.sh

If you only want to see the current recommended model list without opening the menu, run:

./tools/setup/install-local-llms.sh --list
  • License: OWL 3.1

CI Artifacts

GitHub Actions builds desktop artifacts for both target platforms:

  • Linux: OpenCode-x86_64.AppImage
  • macOS: OpenCode.app plus OpenCode-macos.zip

About

A simple desktop wrapper for OpenCode's 'opencode serve' web interface. Installs wizardry's recommended local LLMs with one click in Preferences. Built on the wizardry-apps stack.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages