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>/app 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.
- Busy-port handling: if the configured port is taken, retries on a free port.
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.port |
0 |
Port for the server (0 = OpenCode's default). If busy, a free port is used. |
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.
