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

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!

Chat (Mobile)

File Browser (Mobile)

Inline Diff View

• 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

• 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)

• 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

• 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-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

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

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

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

# Pre-configured admin (optional)
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=your-secure-password

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

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)

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

For WebAuthn/passkey support:

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

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:you@yourdomain.com

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

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

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

• Getting Started - Installation and first-run setup
• Features - Deep dive on all features
• Configuration - Environment variables and advanced setup
• Troubleshooting - Common issues and solutions
• Development - Contributing and local development

MIT