OpenCode Manager provides a mobile-first web interface for managing OpenCode AI agents, allowing users to control, code, and interact with multiple agents from any device. It offers integrated Git functionality, file management, and real-time chat, deployable via Docker for immediate setup.

How It Works

This project is a Progressive Web App (PWA) engineered with a mobile-first philosophy, ensuring a responsive and accessible user experience across various devices. It utilizes Docker for simplified deployment, abstracting away complex setup procedures. The architecture facilitates real-time interactions, including streaming chat, file operations, and Git workflows, all consolidated within a unified web interface.

Quick Start & Requirements

The recommended installation method is Docker:

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

An admin account creation prompt will appear on the first launch. For local development, prerequisites include pnpm, Bun, and OpenCode TUI. Detailed guides and configuration reference are available within the repository.

Highlighted Details

• Repository & Git Management: Supports cloning and managing multiple Git repositories, including private repositories via GitHub PAT, SSH authentication, and Git worktrees. Features a unified Source Control Panel and direct Push PR functionality.
• File Operations: Includes a directory browser with search capabilities, syntax highlighting for code previews, comprehensive file operations (create, rename, delete), drag-and-drop uploads, and ZIP downloads that respect .gitignore rules.
• AI Interaction: Offers real-time streaming chat powered by SSE, slash commands, file mentions with autocomplete, plan/build modes, Mermaid diagram rendering, Text-to-Speech, and Speech-to-Text capabilities.
• AI Configuration: Enables browsing and filtering of available AI models, configuration of API keys/OAuth for various providers, and creation of custom agents with specific system prompts and tool permissions.
• PWA & Mobile: Designed mobile-first with PWA installability, optimized iOS navigation, and background push notifications for agent events when the app is closed.

Maintenance & Community

The README does not specify notable contributors, sponsorships, or community channels (like Discord/Slack).

Licensing & Compatibility

The project is licensed under the MIT License, which generally permits commercial use and closed-source linking with attribution.

Limitations & Caveats

The README does not explicitly detail limitations, alpha status, or known bugs. Configuration for remote/LAN access requires disabling secure cookies (AUTH_SECURE_COOKIES=false), which is not recommended for production environments without HTTPS. Push notifications require VAPID key generation and specific VAPID_SUBJECT formatting for iOS/Safari compatibility.