portal  by hosenur

Mobile-first web UI for AI coding agents

Created 1 month ago
317 stars

Top 85.7% on SourcePulse

GitHubView on GitHub
Project Summary

OpenCode Portal offers a mobile-first, responsive web interface for interacting with OpenCode AI coding sessions, directly addressing the limitations of the official, non-responsive UI. It is designed for developers who require remote access to their OpenCode instances, especially from mobile devices, providing a streamlined experience for session management and AI chat.

How It Works

This project functions as a client interface connecting to a running OpenCode server. It utilizes React Router, IntentUI, and Tailwind CSS for its responsive frontend architecture, with Nitro managing server-side operations. The portal enables session management, real-time AI chat, and features like file referencing via @filename, model selection, and theme toggling, all developed with a mobile-first philosophy.

Quick Start & Requirements

  • Install/Run: The recommended method is bunx openportal. Alternatively, install globally via bun install -g openportal and then execute openportal.
  • Prerequisites: OpenCode must be installed on your system, achievable via bun install -g opencode or brew install sst/tap/opencode. The project is optimized for Bun; Node.js usage may lead to instability.
  • Links: No direct quick-start or demo links are provided in the README.

Highlighted Details

  • A mobile-first, responsive web interface for OpenCode.
  • Comprehensive session management, allowing creation, viewing, and deletion of OpenCode sessions.
  • A real-time chat interface for direct interaction with the AI assistant.
  • Support for referencing files within chat conversations using the @filename syntax.
  • Functionality to select different AI models and switch between dark and light themes.

Maintenance & Community

This project is identified as a personal endeavor and is not officially affiliated with the SST or OpenCode team. Community support is available through a dedicated Discord server. Standard contribution guidelines are outlined for interested developers.

Licensing & Compatibility

  • License: MIT.
  • Compatibility: The MIT license is permissive, generally allowing for commercial use and integration into closed-source projects.

Limitations & Caveats

The portal is a personal project, distinct from the official OpenCode development. It aims to overcome the current lack of mobile responsiveness in the official OpenCode UI. Optimal performance is expected when using Bun; Node.js environments might encounter rough edges or instability.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
14
Issues (30d)
7
Star History
213 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.