|
OpenCode Web Panel on JetBrains Marketplace Embed OpenCode inside JetBrains IDEs. |
OpenCode Web Panel brings the official OpenCode web UI into JetBrains IDEs. It opens OpenCode in a right-side tool window, keeps it focused on the project you are working on, and adds small IDE conveniences on top of the normal OpenCode experience.
Note: This is an unofficial community plugin for OpenCode and is not affiliated with OpenCode.
- OpenCode where you code - Use OpenCode beside your editor instead of switching to the terminal, desktop app, or standalone web app.
- Official web UI - The embedded panel loads OpenCode's own web app, so the core experience stays familiar.
- Project-aware sessions - OpenCode starts on the directory configured for the current IDE project.
- IDE file navigation - Click local file links and code references from chat to open them in the IDE.
- Chat file drop and paste - Drag or paste project files into chat as
@relative/pathreferences, or attach dropped files. - Send code to chat - Add files or the current selection to the OpenCode chat from the editor and project view context menus.
- External links stay outside - HTTP links open in your system browser instead of taking over the panel.
- IDE notifications - OpenCode browser notifications can appear as JetBrains IDE notifications, including Allow/Deny actions for agent permission requests.
- Agent status at a glance - The tool window icon shows when the agent is working or waiting for your input.
- Panel controls in the title bar - Zoom the panel and restart the OpenCode server directly from the tool window.
- Recovery built in - Failed or crashed servers surface a clear error panel with recent logs, retry, and settings shortcuts, and the panel recovers automatically where possible.
- Configurable safeguards - Browser-side convenience features can be disabled if an OpenCode update conflicts with them.
- A JetBrains IDE compatible with this plugin.
- The OpenCode CLI installed on your machine.
- The
opencodecommand available onPATH, or configured manually in the plugin settings.
-
Install from the IDE plugin marketplace:
Settings/Preferences > Plugins > Marketplace > Search "OpenCode Web Panel" > Install
-
Install from JetBrains Marketplace:
Visit OpenCode Web Panel on JetBrains Marketplace and install the plugin.
-
Install manually:
Download the latest version from JetBrains Marketplace, then install it with Settings/Preferences > Plugins > Settings > Install Plugin from Disk...
- Install the OpenCode CLI.
- Open a project in your JetBrains IDE.
- Click the OpenCode Web Panel tool window on the right sidebar.
- Start using OpenCode in the embedded panel.
The plugin starts a local OpenCode server when needed, authenticates the embedded web UI automatically, and opens the configured project directory.
The tool window title bar offers quick controls (also available in the tool window's gear menu on narrow panels):
- Zoom out / Zoom in - Scale the embedded OpenCode UI in 10% steps without reloading. Cmd/Ctrl with +, -, and 0 work inside the panel too.
- Reload Page - Reload the embedded OpenCode UI. The server stays running.
- Restart Server - Stop and restart the shared OpenCode server, and recreate the embedded browser. Recovers a stuck or crashed panel. Asks for confirmation while the server is running, since a restart interrupts OpenCode work in all open projects.
- The gear menu additionally offers Reset Zoom, View Server Log, and OpenCode Web Panel Settings.
- Add to OpenCode Chat (project view, editor tabs) - Insert
@pathreferences for the selected project files into the chat. - Add Selection to OpenCode Chat (editor) - Insert the file reference plus the selected lines as a code snippet.
Both actions open the panel and deliver the input once OpenCode has finished loading. They follow the Enable file drop and paste into chat setting.
Open Settings/Preferences > Tools > OpenCode Web Panel.
- Choose whether the plugin should auto-detect
opencodeor use a custom executable path. - Let OpenCode select a port automatically, or set a fixed port.
- Edit, generate, show, or copy the local server password stored in IntelliJ Password Safe.
- Choose how the OpenCode server reaches the network: the IDE HTTP Proxy, environment variables, or no proxy.
- Restart the local OpenCode server.
- View recent OpenCode server output in your system text viewer.
- Open local file links in the IDE.
- Open external HTTP links in the system browser.
- Enable click-to-navigate for code references in chat.
- Enable file drop and paste into chat, using
@relative/pathfor project file references. - Lock OpenCode to compact layout for panel-friendly use.
- Hide OpenCode's floating website/help button in the panel.
- Sync OpenCode's system color scheme with the IDE theme.
- Suppress project-switch prompts that are not useful inside the embedded panel.
- Forward OpenCode browser notifications to the IDE, optionally with Allow/Deny actions for permission requests.
- Show agent status on the tool window icon.
- Wait briefly for IntelliJ MCP server readiness before launching OpenCode.
Project-specific settings are stored with the IDE project.
- Use Auto detect to open the IDE project root in OpenCode.
- Use Custom Directory to point OpenCode at another directory, such as a monorepo root or a subproject.
- Use Detect to fill the custom directory with the auto-detected project root.
OpenCode does not start
- Check that the OpenCode CLI is installed.
- Run
opencode --versionin a terminal. - The panel shows an error view with recent server output plus Retry, Open Settings, and View Full Log actions.
- Open the plugin settings and use Detect or set the OpenCode executable path manually.
The panel shows a failed server state
- Click Retry in the tool-window status strip or on the error view.
- If it still fails, review the server output shown on the error view.
- With a fixed port, the error view detects port conflicts and offers Use Automatic Port.
- Verify the configured OpenCode project directory exists.
Provider API calls fail behind a proxy
- Open Settings > Tools > OpenCode Web Panel and set HTTP Proxy.
- Use IDE HTTP Proxy forwards the IDE proxy
(Settings > Appearance & Behavior > System Settings > HTTP Proxy),
including auto-detect and PAC. PAC is resolved for a generic HTTPS target, because OpenCode
accepts only a single
HTTP_PROXYvalue. - Use environment variables keeps
HTTP_PROXY/HTTPS_PROXYfrom the environment the IDE was started with. - No proxy removes proxy variables from the OpenCode process.
- Restart the OpenCode server after changing proxy settings.
The panel is stuck, blank, or frozen on “Opening the OpenCode page…”
- Use Restart Server in the tool window title bar or gear menu. This restarts the shared server and recreates the embedded browser.
- Reload Page reloads the UI without restarting the server; use Restart if that is not enough.
The embedded UI behaves unexpectedly after an OpenCode update
- Disable the affected convenience feature under OpenCode UI Settings.
- Reload or reopen the tool window.
- Report the issue with the OpenCode version and plugin version.
Useful development commands:
./gradlew test
./gradlew runIde
./gradlew runIdeForUiTeststestruns JVM and IntelliJ Platform tests.runIdelaunches a sandbox IDE with the plugin installed.runIdeForUiTestslaunches the sandbox IDE with the JetBrains Robot Server enabled.
Repository: https://github.com/moritzfl/intellij-opencode-web-panel
This project started as a fork of an early draft by xausky: https://github.com/xausky/intellij-opencode-web-ui/
This project is licensed under the MIT License.
This plugin is an unofficial community plugin for OpenCode and is not affiliated with OpenCode. Please report plugin issues through GitHub Issues.
If you find this plugin useful, please consider giving it a star.
