by hosenur
Mobile first batteries included web ui for sst/opencode. Git integration, in browser terminal, isolated workspaces.
# Add to your Claude Code skills
git clone https://github.com/hosenur/portal
Disclaimer: This is a personal project and is not related to https://github.com/sst/opencode or the SST team. This portal is a personal-built interface for interacting with OpenCode instances.
A web-based UI for OpenCode, the AI coding agent. This portal provides a browser interface to interact with OpenCode sessions, view messages, and chat with the AI assistant.
The easiest way to run OpenCode Portal is using bunx:
# Navigate to your project directory
cd /path/to/your/project
# Run OpenCode Portal
bunx openportal
Note: OpenPortal works best when paired with Bun. Node.js may have some rough edges.
This will:
You can also install globally:
bun install -g openportal
# Then run in any project directory
openportal
openportal # Start OpenCode + Web UI
openportal run # Start only OpenCode server (no Web UI)
openportal stop # Stop running instances
openportal list # List running instances
openportal clean # Clean up stale entries
openportal [command] [options]
Options:
-h, --help Show help message
-d, --directory <path> Working directory (default: current directory)
-p, --port <port> Web UI port (default: 3000, auto-finds if busy)
--opencode-port <port> OpenCode server port (default: 4000, auto-finds if busy)
--hostname <host> Hostname to bind (default: 0.0.0.0)
--name <name> Instance name (default: directory name)
OpenCode must be installed on your system. Install it using one of these methods:
# Using bun
bun install -g opencode
# Using Homebrew (macOS)
brew install sst/tap/opencode
OpenCode Portal connects to a running OpenCode server and provides:
@filename to reference files)OpenCode comes with its own official web UI that you can access by running:
opencode --port 4096
However, the official UI is currently under development and has some limitations:
This project was inspired by my personal need to access OpenCode from my mobile device when I don't have my laptop around. The goal is to provide a mobile-first, responsive interface for interacting with OpenCode instances remotely.
This portal is designed for remote access to your OpenCode instance. Deploy the portal on a VPS alongsi...