Portal

Overview

Portal is a web UI for OpenCode, an open-source flexible coding agent. It can be deployed on a VPS alongside your codebase and OpenCode, connected securely through Tailscale. This enables you to prompt and make changes to your codebase remotely through a web interface.

Technical Architecture

The Portal architecture ensures secure and isolated codebase modification:

• Docker Container Isolation: The codebase runs in an isolated Docker container, preventing mishaps and ensuring system safety
• In-browser Terminal: Uses xterm connected to the Docker socket for real-time terminal access
• Tailscale Networking: Provides secure, encrypted networking to access the VPS remotely
• Deployment Flow: Deploy on VPS → Connect via Tailscale → Prompt OpenCode → Changes made in isolated Docker container → View terminal via xterm

Features

• Web-based Interface: Access OpenCode coding agent through any web browser
• VPS Deployment: Deploy alongside your codebase on any VPS
• Secure Tailscale Connectivity: Encrypted networking for remote access
• Docker Container Isolation: Safe execution environment prevents system damage
• In-browser Terminal: Real-time terminal access via xterm + Docker socket
• Remote Codebase Modification: Make changes to your code through natural language prompts

Tech Stack

• OpenCode: The underlying coding agent that processes prompts and modifies code
• Docker: Container isolation for safe codebase execution
• Tailscale: Secure networking for VPS access
• xterm: In-browser terminal emulator
• Docker Socket: Connects terminal to container environment

Status

Currently in active development.