Overview
OpenCode Terminal embeds OpenCode's web UI in a VS Code side panel. It spawns an external opencode serve process and loads the official UI at http://127.0.0.1:<port>/<workspace-dir> in a webview iframe — sharing the exact same binary, config, auth, providers, MCP servers, agents, and rules as the terminal TUI.
No custom terminal emulator, no xterm.js, no node-pty — just OpenCode's own UI.
The opencode binary is not bundled: install and authenticate it once, and the extension drives it from inside the editor.
For more information, visit the repository.
Requirements
- OpenCode CLI (
opencode on PATH, or set opencode-vsc.command to a full path).
- VS Code 1.90+.
Features
- OpenCode in the Activity Bar side panel via a webview iframe.
- Shares the exact same config as the terminal TUI (MCP servers, agents, rules, auth, providers) because it runs the same binary against the same config files.
- Auto-manages the server process: starts it when the panel opens, stops it when the panel closes or the extension deactivates.
- Robust PATH resolution: checks
PATH, common install locations (~/.opencode/bin, Homebrew, /usr/local), then falls back to your login shell (zsh/bash) — works even when VS Code is launched from Finder.
- Fixed ports, so URLs stay stable across restarts: the server on
4097, the bridge proxy the panel actually loads on 4098.
Restart button in the panel title bar.
Configuration
| Setting |
Default |
Description |
opencode-vsc.command |
opencode |
Command (or full path) used to launch the OpenCode server. |
opencode-vsc.cwd |
"" |
Directory the server runs in. Empty = workspace folder of the active editor (falling back to the first workspace folder, then your home directory). |
Ports are fixed, not configurable: the OpenCode server listens on 4097, and the
bridge-injecting proxy — the origin the panel iframe actually loads — on 4098.
Commands
OpenCode: Focus Side Panel — open/focus the side panel.OpenCode: Restart Session — restart the server and reload the UI (also available as a panel title-bar button).
Issues
Found a bug or have a feature request? Please open an issue on GitHub.
License
OpenCode is released under the MIT License. It embeds the MIT-licensed OpenCode web UI through its documented serve interface.
