Desktop app for OpenCode with multi-project workspaces, streaming chat, prompt queue, model switching, voice input, and MCP tools.

Download latest release · Why OpenGUI · Build from source

OpenGUI gives OpenCode users desktop workflow for long coding sessions. Manage multiple projects visually, watch responses stream live, queue prompts while agent works, and switch models or agents without terminal juggling.

Early but usable. Bug reports and PRs welcome.

Why OpenGUI

OpenGUI is for OpenCode users who want stronger visual workflow than terminal alone:

• Manage multiple projects at once with separate sessions per workspace
• See streaming responses live with token and context usage
• Queue prompts while agent is busy instead of waiting to type next step
• Switch providers, models, agents, and variants from UI
• Configure MCP tools and skills without leaving app
• Use voice input with Whisper-compatible transcription endpoint

Highlights

• Multi-project workspaces for parallel coding sessions
• Real-time streaming over SSE with live usage tracking
• Prompt queue that auto-dispatches when assistant becomes idle
• Model & agent selection directly from chat workflow
• Slash commands from prompt box
• Syntax highlighting + math rendering with Shiki and KaTeX
• Dark/light theme with system-aware toggle
• Cross-platform builds for Linux, macOS, and Windows

Download

Grab prebuilt app from latest release:

• Linux: .deb
• macOS: .dmg
• Windows: .exe installer

Requirements

• OpenCode CLI installed and available in your PATH

Windows prerequisite: OpenCode must be available on your PATH or at %USERPROFILE%\.opencode\bin\opencode.exe.

Note: Windows builds are unsigned. Windows SmartScreen will warn on first launch. Click More info -> Run anyway.

Build from source

Prerequisites

• Bun v1.2+
• OpenCode CLI installed and available in your PATH
• Electron installed through project dependencies

Install dependencies:

bun install

No manual config file needed. Connection settings live in UI.

Development

Run web frontend + Electron with HMR:

bun run dev

Run only web frontend:

bun run dev:web

Production

Build frontend bundle:

bun run build

Run Electron app in production mode:

bun run start:electron

Distribution

Build Linux .deb:

bun run dist

Build macOS .dmg:

bun run dist:mac

Build Windows .exe installer:

bun run dist:win

Architecture

main.cjs            Electron main process (window management, IPC)
preload.cjs         Preload script (contextBridge API for renderer)
opencode-bridge.mjs IPC bridge to the OpenCode SDK (SSE, sessions, prompts)
src/
  index.ts          Bun web server (development + production)
  index.html        HTML entry point
  frontend.tsx      React entry point
  App.tsx           Main app layout
  hooks/
    use-opencode.tsx  Central state management (context + reducer)
    useSTT.ts         Speech-to-text hook
  components/       UI components (sidebar, messages, prompt box, etc.)
  lib/              Utility modules
  types/            TypeScript type definitions

Configuration

OpenGUI stores connection and UI preferences via the app settings interface.

Voice input (speech-to-text) requires a Whisper-compatible transcription server. Set the endpoint URL in Settings > General > Voice transcription endpoint. The microphone button only appears when an endpoint is configured. The server should accept a multipart POST with an audio file field and return { text, language, duration_seconds }.

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.

Star History

If you find OpenGUI useful, consider giving it a star -- it helps others discover the project.

License

MIT