portal

Name: portal
Author: hosenur

Verified

Mobile first batteries included web ui for sst/opencode. Git integration, in browser terminal, isolated workspaces.

759stars

61forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/hosenur/portal

Getting Started

Guides for using ai agents skills like portal.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/10/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "next: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "nextra: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "nextra-theme-docs: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-05-10T06:36:09.518Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is portal?

portal is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by hosenur. Mobile first batteries included web ui for sst/opencode. Git integration, in browser terminal, isolated workspaces. It has 759 GitHub stars.

Is portal safe to use?

Yes. portal passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install portal?

Clone the repository with "git clone https://github.com/hosenur/portal" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is portal written in?

portal is primarily written in TypeScript. It is open-source under hosenur on GitHub, so you can review or fork the full source.

Are there alternatives to portal?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh portal against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

codex-mobile yahoo-finance2

OpenCode 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.

Quick Start

Using bunx (Recommended)

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:

Start the OpenCode server (default port: 4000)
Start the web UI (default port: 3000)
Automatically find available ports if defaults are busy

Installation

You can also install globally:

bun install -g openportal

# Then run in any project directory
openportal

CLI Commands

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

CLI Options

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)

Prerequisites

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

Overview

OpenCode Portal connects to a running OpenCode server and provides:

Session management (create, view, delete sessions)
Real-time chat interface with the AI assistant
File mention support (@filename to reference files)
Model selection
Dark/light theme support

Why This Project?

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:

Not mobile responsive
Limited mobile experience

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.

Use Case

This portal is designed for remote access to your OpenCode instance. Deploy the portal on a VPS alongside OpenCode, then use Tailscale (or similar VPN) to securely connect from your mobile device or any other machine.

Example setup:

[Your Phone] ---(Tailscale)---> [VPS running Portal + OpenCode]

Tech Stack

React Router - React framework
IntentUI - UI library
Tailwind CSS - Styling
Nitro - Server
OpenCode SDK - OpenCode API client

Contributing

Contributions are welcome! Here's how you can help:

Feedback & Feature Requests

Visit oc-portal.userjot.com to submit feedback and feature requests.

Reporting Issues

Bugs: Report bugs by opening an issue with a clear description and steps to reproduce

Development Setup

Fork the repository

Clone your fork:

git clone https://github.com/YOUR_USERNAME/portal.git
cd portal

Install dependencies:
```
bun install
```
Run the development server:
```
bun dev
```

Pull Request Process

Create a feature branch from main
Make your changes following the existing code style
Test your changes thoroughly
Update documentation if needed
Submit a pull request with a clear description

Code Style

Use TypeScript for all new code
Follow the existing component patterns in apps/web/src/components/
Use Tailwind CSS for styling
Maintain consistent naming conventions
Add proper TypeScript types

Getting Help

Join our Discord community
Check existing issues before creating new ones
Join the discussion in existing issues
Be respectful and constructive in all interactions

License

MIT