Mobile-first web interface for OpenCode AI agents. Manage, control, and code with OpenCode 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. View diffs, edit files and much more.

• Multi-Repository Support - Clone and manage multiple git repos/worktrees in local workspaces
• Private Repository Support - GitHub PAT configuration for cloning private repos
• Worktree Support - Create and manage Git worktrees for working on multiple branches

• Source Control Panel - Comprehensive Git operations in a modal interface with tabs for Changes, Commits, and Branches
• Git Diff Viewer - View file changes with unified diff, line numbers, and addition/deletion counts
• Git Status Panel - See all uncommitted changes (modified, added, deleted, renamed, untracked)
• Branch Management - Switch, create, and manage branches through the Source Control Panel
• Branch/Worktree Creation - Create new branch workspaces from any repository
• Ahead/Behind Tracking - Shows commits ahead/behind remote
• Push PRs to GitHub - Create and push pull requests directly from your phone

• Directory Navigation - Browse files and folders with tree view
• File Search - Search files within directories
• Syntax Highlighting - Code preview with syntax highlighting
• File Operations - Create files/folders, rename, delete
• Drag-and-Drop Upload - Upload files by dragging into the browser
• Large File Support - Virtualization for large files
• ZIP Download - Download repos as ZIP excluding gitignored files

• Slash Commands - Built-in commands (/help, /new, /models, /export, /compact, etc.)
• Custom Commands - Create custom slash commands with templates
• File Mentions - Reference files with @filename autocomplete
• Plan/Build Mode Toggle - Switch between read-only and file-change modes
• Mermaid Diagram Support - Visual diagram rendering in chat messages
• Session Management - Create, search, delete, and bulk delete sessions
• Real-time Streaming - Live message streaming with SSE

• Model Selection - Browse and select from available AI models with filtering
• Provider Management - Configure multiple AI providers with API keys or OAuth
• OAuth Authentication - Secure OAuth login for supported providers (Anthropic, GitHub Copilot)
• Context Usage Indicator - Visual progress bar showing token usage
• Agent Configuration - Create custom agents with system prompts and tool permissions

• MCP Server Configuration - Add local (command-based) or remote (HTTP) MCP servers
• Server Templates - Pre-built templates for common MCP servers
• Enable/Disable Servers - Toggle servers on/off with auto-restart

• Theme Selection - Dark, Light, or System theme
• Keyboard Shortcuts - Customizable keyboard shortcuts
• OpenCode Config Editor - Raw JSON editor for advanced configuration

• Mobile-First Design - Responsive UI optimized for mobile use
• PWA Support - Installable as Progressive Web App
• iOS Keyboard Support - Proper keyboard handling on iOS
• Enter Key Send - Press Enter to automatically close keyboard and send messages
• Swipe-to-Navigate - Swipe right from left edge to navigate back

Files (Mobile)	Files (Desktop)
Chat (Mobile)	Chat (Desktop)
Inline Diff View

• Authentication - User authentication and session management

See the Roadmap for planned features and future development.

# Clone the repository
git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager

# Start with Docker Compose (single container)
docker-compose up -d

# Access the application at http://localhost:5001

The Docker setup automatically:

• Installs OpenCode if not present
• Builds and serves frontend from backend
• Sets up persistent volumes for workspace and database
• Includes health checks and auto-restart

Docker Commands:

# Start container
docker-compose up -d

# Stop and remove container
docker-compose down

# Rebuild image
docker-compose build

# View logs
docker-compose logs -f

# Restart container
docker-compose restart

# Access container shell
docker exec -it opencode-manager sh

OpenCode Manager uses a mise-first workflow for environment setup and command execution.

• If a repository has a mise.toml, run mise install at the project root before other commands
• Use mise-managed runtimes and tools for project commands (for example mise exec -- <command> when you need pinned versions)
• If no mise.toml is present, use the preinstalled base-image tooling

OpenCode Manager creates a default AGENTS.md file in the workspace config directory (/workspace/.config/opencode/AGENTS.md). This file provides global instructions to AI agents working within the container.

Default instructions include:

• Reserved ports (5003 for OpenCode Manager, 5551 for OpenCode server)
• Mise-first execution (mise.toml detection, mise install, and mise-managed commands)
• Preinstalled base-image tools with intended usage guidance (for example gh, jq, rclone, rg, uv)

Editing AGENTS.md:

• Via UI: Settings > OpenCode > Global Agent Instructions
• Via file: Edit /workspace/.config/opencode/AGENTS.md directly

This file is merged with any repository-specific AGENTS.md files, with repository instructions taking precedence for their respective codebases.

For contributors who want to develop locally instead of using Docker.

Prerequisites:

• pnpm - Package manager (required for workspaces)
• Bun - Backend runtime
• OpenCode TUI - npm install -g @opencode/tui

# Clone the repository
git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager

# Install dependencies (uses pnpm workspaces)
pnpm install

# Copy environment configuration
cp .env.example .env

# Start development servers (backend + frontend)
pnpm dev

OpenCode WebUI supports OAuth authentication for select providers, offering a more secure and convenient alternative to API keys.

• Anthropic (Claude) - OAuth login with Claude Pro/Max accounts
• GitHub Copilot - OAuth device flow authentication

1. Navigate to Settings → Provider Credentials
2. Select a provider that shows the "OAuth" badge
3. Click "Add OAuth" to start the authorization flow
4. Choose authentication method:
   • "Open Authorization Page" - Opens browser for sign-in
   • "Use Authorization Code" - Provides code for manual entry
5. Complete authorization in the browser or enter the provided code
6. Connection status will show as "Configured" when successful