Home

opencode Studio Wiki

Welcome to the opencode Studio documentation — the modern GUI for opencode.

---

📑 Table of Contents

Page	Description
Getting Started	Installation, prerequisites, and your first chat
Features Guide	Deep dive into every feature with usage tips
Architecture	System design, data flow, and package structure
Configuration	All settings, commands, modes, and keyboard shortcuts
Troubleshooting	Common issues, error messages, and fixes
Development Guide	Building from source, testing, and contributing
FAQ	Frequently asked questions

---

What is opencode Studio?

opencode Studio is a cross-IDE extension that wraps the full opencode server in a rich, native-feeling GUI. It brings the features that a terminal surface can't provide:

• 🖼️ Image & file attachments — paste, drag-and-drop, or pick
• 🔎 @-mention file search — fuzzy search + text search + symbol search
• ⚡ / slash commands — discover commands from an autocomplete palette
• 💬 Streaming chat — GFM markdown, syntax highlighting, inline images
• 🔧 Tool call cards — expandable cards with status and output
• 🧠 Reasoning display — thinking/reasoning tokens rendered alongside output
• 🛡️ Permission modes — Manual, Auto, Bypass, Plan
• 🧠 Model & agent pickers — switch on the fly
• 🗂️ Session management — browse, resume, delete, create
• ■ Abort/Stop — cancel in-flight requests
• ♻️ Auto-resilience — transient retries, server auto-restart, one-click Retry

Supported Editors

Editor	Install Method	Status
VS Code	Marketplace	✅
Cursor	Open VSX	✅
Windsurf	Open VSX	✅
Antigravity	Open VSX	✅
VSCodium · code-server	Open VSX	✅

Quick Links

• 🏠 GitHub Repository
• 🐛 Report a Bug
• 💡 Request a Feature
• 💬 Discussions
• 📦 VS Code Marketplace
• 🟣 Open VSX Registry