Mobile-first web interface for managing, controlling, and coding with multiple OpenCode AI agents. Features multi-repo Git management, real-time chat, voice interaction, MCP server integration, and self-hosted deployment via Docker.
OpenCode Manager is a mobile-first web interface serving as a third-party management tool for OpenCode AI, maintained by Chris Scott (chriswritescode-dev).
Core Capabilities#
Git Integration#
- Multi-repo support with SSH authentication
- Worktrees management
- Unified diff view with line numbers
- Create PRs directly from UI
File Management#
- Directory browser with tree view
- Syntax highlighting
- Create/rename/delete files
- ZIP download functionality
Real-time Chat#
- SSE real-time streaming responses
- Slash commands support
- @file mention functionality
- Plan/Build modes
- Mermaid diagram rendering
Audio Features#
- Text-to-Speech (TTS): Browser native + OpenAI-compatible API
- Speech-to-Text (STT): Browser native + OpenAI-compatible API
AI Configuration#
- Model selection and provider configuration
- OAuth support: Anthropic, GitHub Copilot
- Custom agents and system prompts
MCP Support#
- Local and remote MCP server support
- Pre-built templates
Memory Plugin (Optional)#
- Persistent project knowledge
- Semantic search
- Planning state management
- Compression awareness
Mobile Experience#
- Responsive UI
- PWA installable
- iOS optimized (keyboard handling, swipe navigation)
- Push notifications (VAPID)
Architecture#
Project Structure#
opencode-manager/
├── backend/ # Bun + Hono backend
├── frontend/ # React + Vite + Tailwind frontend
├── packages/memory/ # Memory plugin package
├── shared/ # Shared code
├── docs/ # MkDocs documentation
└── scripts/ # Build scripts
Backend Stack#
- Runtime: Bun
- Web Framework: Hono
- Auth: better-auth + @better-auth/passkey
- Push: web-push
- Validation: Zod
- Testing: Vitest
Frontend Stack#
- Framework: React 19
- Build Tool: Vite 7
- Styling: Tailwind CSS 4
- State Management: Zustand
- Data Fetching: @tanstack/react-query
- UI Components: Radix UI series
- Editor: Monaco Editor
- Markdown Rendering: react-markdown + remark-gfm + rehype-highlight
- Charts: Mermaid
- Drag & Drop: @dnd-kit
Deployment#
Docker Quick Deploy (Recommended)#
git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
cp .env.example .env
docker-compose up -d
# Access at http://localhost:5003
Environment Variables#
AUTH_SECRET=your-secure-random-secret
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=your-secure-password
AUTH_TRUSTED_ORIGINS=http://localhost:5003,https://yourdomain.com
AUTH_SECURE_COOKIES=false # Set to true when using HTTPS
Typical Use Cases#
- Remote Code Management: Manage multiple Git repos from phone or tablet anywhere
- AI-Assisted Coding: Real-time interaction with OpenCode AI agents for code suggestions and automation
- Code Review: View diffs, manage branches, create PRs
- Multi-Device Collaboration: Use on any device after PWA installation with push notifications
- Self-Hosted Deployment: One-click Docker deployment for privacy-sensitive environments
License#
MIT License
Version Info#
- Current Version: v0.9.04
- Primary Language: TypeScript (98.8%)
- Package Manager: pnpm@10.28.1
Pending Confirmation#
- Commercial Support: No mention of commercial support or enterprise edition
- Performance Benchmarks: No public performance test data
- Security Audit: No third-party security audit report
- OpenCode AI Dependency: Compatible OpenCode AI version not specified