opencode-web-ui

简介

OpenCodeWeb 是一款 JetBrains IDE（IntelliJ IDEA、PyCharm、WebStorm 等）插件，为 OpenCode 提供便捷的 Web UI 集成。

Plugin Description

Note: This is an unofficial plugin for OpenCode, maintained by the community and not affiliated with OpenCode.

Features

• Auto-start Service - Click the sidebar icon to automatically check and start the OpenCode server
• Smart Monitoring - Periodically check server status and automatically restart failed services
• Auto Cleanup - Automatically stop OpenCode service when IDE exits to release resources
• Sidebar Integration - Display plugin icon in the right sidebar, click to access OpenCode Web UI
• Project Sync - Automatically load the Web interface for the current project

Use Cases

• Developers who need to use OpenCode Web UI in JetBrains IDE
• Developers who need to automatically manage OpenCode servers
• Users who want to quickly view the AI assistant interface during coding

安装

• 使用 IDE 内置插件系统：

  Settings/Preferences > Plugins > Marketplace > 搜索 "open code web" > Install

• 使用 JetBrains Marketplace：

  访问 JetBrains Marketplace 进行安装

  也可以从 JetBrains Marketplace 下载最新版本，然后使用 Settings/Preferences > Plugins > ⚙️ > 从磁盘安装插件...

• 手动安装：

  下载最新版本，然后使用 Settings/Preferences > Plugins > ⚙️ > 从磁盘安装插件...

使用说明

1. 确保已安装 OpenCode CLI 工具
   插件需要在系统 PATH 中找到 opencode 命令。如未安装，请访问 OpenCode 官方文档进行安装。

2. 打开插件侧边栏
   在 IDE 右侧边栏找到 "OpenCodeWeb" 图标并点击。

3. 自动启动服务
   插件会自动检查 127.0.0.1:4096 端口，如果服务未运行，将自动执行：

   opencode serve --hostname 127.0.0.1 --port 4096
   

4. 访问 Web UI
   服务启动成功后，侧边栏将自动加载当前项目的 OpenCode Web 界面。

配置

插件默认使用以下配置：

• 主机: 127.0.0.1
• 端口: 4096

如需修改，请确保 OpenCode CLI 使用相同的端口和主机启动。

故障排除

问题：插件无法找到 opencode 命令

• 确保 OpenCode CLI 已正确安装
• 确保 opencode 可执行文件在系统的 PATH 环境变量中
• 在终端中运行 opencode --version 验证安装

问题：服务启动失败

• 检查端口 4096 是否已被其他程序占用
• 查看 IDE 日志窗口中的错误信息
• 手动运行启动命令排查问题

开发

项目基于 IntelliJ Platform Plugin Template 开发。

许可证

本项目采用 MIT 许可证。

免责声明

本插件是 OpenCode 的非官方社区插件，与 OpenCode 官方没有任何关联。使用本插件产生的任何问题，请通过 GitHub Issues 反馈。

---

💡 如果你觉得这个插件有帮助，欢迎给个 Star 🌟