██████╗  ██████╗██████╗
 ██╔═══██╗██╔════╝██╔══██╗
 ██║   ██║██║     ██║  ██║
 ██║   ██║██║     ██║  ██║
 ╚██████╔╝╚██████╗██████╔╝
  ╚═════╝  ╚═════╝╚═════╝

Run OpenCode AI coding agent in a macOS + OrbStack Docker environment, powered by Oh My OpenCode multi-agent orchestration.

Upstream note: the GitHub repository was renamed to oh-my-openagent, while the published npm package and config filenames still use oh-my-opencode for compatibility.

Features

• One-command launch (ocd) with auto workspace detection
• Multi-window support (auto port allocation + lock mechanism)
• macOS integration (desktop notifications, clipboard bridge, auto-open links)
• Multi-agent collaboration via Oh My OpenCode (Sisyphus, Oracle, Hephaestus, etc.)
• MCP servers & Playwright browser automation
• Persistent user-owned configuration (OCD never overwrites)

Quick Start

1. Install Dependencies

brew install jq fswatch terminal-notifier

2. Clone and Configure

git clone https://github.com/aaajiao/opencode-on-dorker.git ~/opencode
cd ~/opencode
cp env.example .env
nano .env  # Fill in your API keys

3. Add to PATH

echo 'export PATH="$HOME/opencode/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. First Build

ocd -r

Detailed setup: docs/GETTING_STARTED.md

Usage

ocd                  # Launch in project dir (auto-detect workspace)
ocd -p 5000          # Custom port
ocd --here           # Mount current directory only
ocd -r               # Rebuild image
ocd init             # Initialize project config
ocd config           # View config status
ocd scan             # Scan and register git projects

Full reference: docs/CLI_REFERENCE.md

Environment Variables

.env format (pure KEY=VALUE — no quotes, no comments):

OPENAI_API_KEY=sk-proj-xxxx
ANTHROPIC_API_KEY=sk-ant-xxxx
GITHUB_TOKEN=ghp_xxxx
EXA_API_KEY=your-exa-api-key

Oh My OpenCode Agents

Scenario	Agent	Example
Complex tasks	Sisyphus (default)	Just type the task
Deep autonomous work	Hephaestus	deep: prefix or delegated
Architecture / Debug	@oracle	@oracle analyze this deadlock
Find docs & examples	@librarian	@librarian React 18 concurrency
Codebase search	@explore	@explore where is user auth
Task planning	@prometheus	@prometheus plan auth refactor
Large refactor	ulw:	ulw: refactor auth module

Full guide: docs/OH_MY_OPENCODE.md

Documentation

Document	Description
Getting Started	Installation & first build
CLI Reference	All flags, subcommands, examples
Configuration	Directory structure, config lifecycle
Architecture	Mac/Docker mapping, IPC
Developer Guide	Extension & customization
Agent Guide	Oh My OpenCode multi-agent system

Requirements

• macOS
• OrbStack (recommended) or Docker Desktop
• jq, fswatch, terminal-notifier

License

MIT