-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Frequently asked questions about opencode Studio.
A cross-IDE GUI extension for opencode that adds image attachments, file search, slash commands, tool approval modes, streaming chat with tool cards, and session management.
No. opencode Studio is a community-built GUI that uses the public opencode SDK and server API.
VS Code, Cursor, Windsurf, Antigravity, VSCodium, and code-server — any editor with the VS Code extension API.
Yes. MIT licensed. You need your own API keys for AI model providers, which may have usage costs.
- ✋ Manual — approve every tool action
- ⚡ Auto — auto-approve safe actions, prompt on risky ones (shell, network, delete, install)
- ⏩ Bypass — auto-approve everything
- ◔ Plan — read-only mode, no file edits
It depends on the model. Vision-capable models (GPT-4o, Claude Sonnet, Gemini) can process images. Text-only models will ignore the image context.
Images (PNG, JPEG, GIF, WebP, SVG), text files, code files, JSON, CSV, YAML, and more.
Yes! Chain as many as you need: @file1.ts @file2.ts make these consistent.
It sends session.abort to cancel the in-flight request immediately. The UI returns to the ready state.
-
•— tool is running -
✓(green) — completed successfully -
✗(red) — error occurred
Click the card to expand and see the full output.
On your local machine, managed by the opencode server. They persist across editor restarts.
Yes. Open the session sidebar (☰), hover over a session, click 🗑, then confirm with the Delete button.
Only to your configured AI provider through the opencode server. No other external services.
opencode's client-server architecture requires opencode serve running locally. The extension manages this automatically. If the primary spawn fails, it falls back to the SDK's cross-platform launcher.
Yes. Set opencode.serverUrl to the remote URL.
It auto-restarts up to 5 times with exponential backoff (1s → 2s → 4s → 8s → 15s cap). After 5 failures, it stops and asks you to check logs.
Yes, if opencode supports your local model setup. Configure the provider in opencode's config — it'll appear in the model picker.
Same GUI — the editor tab (opencode: Open in Editor Tab) just gives more screen space.