opencode-manager

opencode-manager

Mobile-first web interface for OpenCode AI agents. Manage, control, and code with multiple OpenCode agents from any device - your phone, tablet, or desktop. Features Git integration, file management, and real-time chat in a responsive PWA. Deploy with Docker for instant setup.

Stars: 247

Visit
 screenshot

OpenCode Manager is a mobile-first web interface for managing and coding with OpenCode AI agents. It allows users to control and code from any device, including phones, tablets, and desktops. The tool provides features for repository and Git management, file management, chat and sessions, AI configuration, as well as mobile and PWA support. Users can clone and manage multiple git repos, work on multiple branches simultaneously, view changes, commits, and branches in a unified interface, create pull requests, navigate files with tree view and search, preview code with syntax highlighting, and perform various file operations. Additionally, the tool supports real-time streaming, slash commands, file mentions, plan/build modes, Mermaid diagrams, text-to-speech, speech-to-text, model selection, provider management, OAuth support, custom agents creation, and more. It is optimized for mobile devices, installable as a PWA, and offers push notifications for agent events.

README:

OpenCode Manager

OpenCode Manager

Mobile-first web interface for OpenCode AI agents. Manage, control, and code from any device - your phone, tablet, or desktop.

OpenCode Manager Demo

Quick Start

git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
docker-compose up -d
# Open http://localhost:5003

On first launch, you'll be prompted to create an admin account. That's it!

Screenshots

Chat (Mobile)
chat-mobile
File Browser (Mobile)
files-mobile
Inline Diff View
inline-diff-view

Features

Repository & Git

  • Multi-Repository Support - Clone and manage multiple git repos with private repo support via GitHub PAT
  • SSH Authentication - SSH key authentication for git repositories
  • Git Worktrees - Work on multiple branches simultaneously
  • Source Control Panel - View changes, commits, and branches in a unified interface
  • Diff Viewer - Unified diffs with line numbers and change counts
  • Push PRs - Create and push pull requests directly from the UI

File Management

  • Directory Browser - Navigate files with tree view and search
  • Syntax Highlighting - Code preview with highlighting for all major languages
  • File Operations - Create, rename, delete, and drag-and-drop upload
  • ZIP Download - Download repos as ZIP (respects .gitignore)

Chat & Sessions

  • Real-time Streaming - Live message streaming with SSE
  • Slash Commands - Built-in (/help, /new, /compact) and custom commands
  • File Mentions - Reference files with @filename autocomplete
  • Plan/Build Modes - Toggle between read-only and file-change modes
  • Mermaid Diagrams - Visual diagram rendering in chat
  • Text-to-Speech - Listen to AI responses with browser or OpenAI-compatible TTS
  • Speech-to-Text - Dictate messages using browser speech recognition or OpenAI-compatible STT

AI Configuration

  • Model Selection - Browse and filter available AI models
  • Provider Management - Configure API keys or OAuth for providers
  • OAuth Support - Secure OAuth login for Anthropic and GitHub Copilot
  • Custom Agents - Create agents with custom system prompts and tool permissions
  • MCP Servers - Add local or remote MCP servers with pre-built templates

Mobile & PWA

  • Mobile-First Design - Responsive UI optimized for mobile
  • PWA Installable - Add to home screen on any device
  • iOS Optimized - Proper keyboard handling and swipe navigation
  • Push Notifications - Background alerts for agent events when app is closed

Installation

Docker (Recommended)

git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
docker-compose up -d

The container automatically installs OpenCode, builds the frontend, and sets up persistent volumes.

Common commands:

docker-compose up -d      # Start
docker-compose down       # Stop
docker-compose logs -f    # View logs
docker-compose restart    # Restart

Local Development

For contributors who want to develop locally:

# Prerequisites: pnpm, Bun, OpenCode TUI (npm i -g @opencode/tui)

git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
pnpm install
cp .env.example .env
pnpm dev

Configuration

Authentication

OpenCode Manager uses single-user authentication. Create your admin account on first launch, or pre-configure via environment variables:

# Pre-configured admin (optional)
[email protected]
ADMIN_PASSWORD=your-secure-password

# Required for production
AUTH_SECRET=your-secure-random-secret  # Generate with: openssl rand -base64 32

Remote/LAN Access

For HTTP access on local networks:

AUTH_TRUSTED_ORIGINS=http://localhost:5003
AUTH_SECURE_COOKIES=false  # Required when not using HTTPS (cookies won't work over plain HTTP otherwise)

OAuth Providers (Optional)

Enable social login by configuring OAuth credentials:

# GitHub
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...

# Google
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...

# Discord
DISCORD_CLIENT_ID=...
DISCORD_CLIENT_SECRET=...

Passkeys

For WebAuthn/passkey support:

PASSKEY_RP_ID=yourdomain.com
PASSKEY_RP_NAME=OpenCode Manager
PASSKEY_ORIGIN=https://yourdomain.com

Push Notifications (VAPID)

Enable push notifications for the PWA (background alerts for agent questions, permission requests, errors, and session completions):

# Generate keys: npx web-push generate-vapid-keys
VAPID_PUBLIC_KEY=your-public-key
VAPID_PRIVATE_KEY=your-private-key
VAPID_SUBJECT=mailto:[email protected]

Important: VAPID_SUBJECT MUST use mailto: format for iOS/Safari push notifications to work. Apple's push service rejects https:// subjects.

Dev Server Ports

The Docker container exposes ports 5100-5103 for running dev servers inside repositories:

# Example: Vite
server: { port: 5100, host: '0.0.0.0' }

# Access at http://localhost:5100

Documentation

For detailed guides and configuration reference, see the Documentation Site.

License

MIT

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for opencode-manager

Similar Open Source Tools

For similar tasks

For similar jobs