Metadata

name: oh-my-openagent
description: Configure and operate oh-my-openagent (OmO), the OpenCode plugin that adds multi-agent orchestration, skills, hooks, MCPs, and multi-provider model routing. Use this skill when the user asks about OmO configuration, agent setup, model selection, category tuning, hook management, or provider authentication.
homepage: https://github.com/code-yeongyu/oh-my-openagent
metadata: {"clawdbot":{"emoji":"🤖"}}

oh-my-openagent

oh-my-openagent (OmO) is an OpenCode plugin that transforms a single-agent coding assistant into a multi-agent orchestration system with 11 specialized agents, 8 task categories, 40+ hooks, built-in skills, MCPs, and multi-provider model routing.

Repository: https://github.com/code-yeongyu/oh-my-openagent Discord: https://discord.gg/PUwSMR9XNk Config schema: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json

When to use this skill

User asks how to configure oh-my-openagent or oh-my-opencode
User wants to change which model an agent or category uses
User asks about the agent system (Sisyphus, Oracle, Hephaestus, etc.)
User wants to add, disable, or configure hooks
User asks about task delegation, categories, or background tasks
User needs help with provider authentication or model routing
User wants to create or manage custom skills
User asks about slash commands like /ralph-loop, /start-work, /refactor

Installation

bunx oh-my-opencode install

On Windows, interactive mode may crash. Configure manually instead:

Edit ~/.config/opencode/opencode.json:

{
  "plugin": ["oh-my-opencode@latest"]
}

Edit ~/.config/opencode/oh-my-opencode.json for agent/category overrides.

Core concepts

Agents

OmO provides 11 agents, each with a default model and role:

Agent	Role	Default Model
Sisyphus	Main orchestrator	claude-opus-4-6
Hephaestus	Deep worker (code-heavy)	gpt-5.3-codex
Oracle	Architecture consultant (read-only)	gpt-5.4
Librarian	Documentation and reference search	gemini-3-flash
Explore	Fast codebase grep	grok-code-fast-1
Multimodal-Looker	Vision / image analysis	gpt-5.3-codex
Prometheus	Planner	claude-opus-4-6
Metis	Plan consultant	claude-opus-4-6
Momus	Plan reviewer	gpt-5.4
Atlas	Todo orchestrator	claude-sonnet-4-6
Sisyphus-Junior	Delegated task worker	(category-dependent)

See references/agents.md for full details including fallback chains.

Category	Best For	Default Model
visual-engineering	Frontend, UI/UX, design	gemini-3.1-pro
ultrabrain	Hard logic-heavy tasks	gpt-5.4
deep	Autonomous problem-solving	gpt-5.3-codex
artistry	Creative, unconventional approaches	gemini-3.1-pro
quick	Trivial single-file changes	claude-haiku-4-5
unspecified-low	Low-effort misc tasks	claude-sonnet-4-6
unspecified-high	High-effort misc tasks	claude-opus-4-6
writing	Documentation, prose	gemini-3-flash

Configuration

All config lives in ~/.config/opencode/oh-my-opencode.json.

Override any agent:

{
  "agents": {
    "sisyphus": {
      "model": "my-preferred-model",
      "fallback_models": ["fallback-1", "fallback-2"]
    }
  }
}

Override any category:

{
  "categories": {
    "quick": {
      "model": "fast-cheap-model"
    }
  }
}

See references/configuration.md for the full config reference.

Provider priority

OmO resolves models through a provider priority chain:

Native (built-in to OpenCode)
Kimi for Coding
GitHub Copilot
Venice
OpenCode Go
OpenCode Zen
Z.ai Coding Plan

Each agent's default model has a fallback chain. If no provider can serve a model, OmO tries the next fallback. See references/providers.md.

Tools

OmO injects 40+ tools into agents. See references/tools.md for the full list.

Hooks

40+ built-in hooks that fire on events (session start, file save, pre-commit, etc.). See references/hooks.md.

Skills

Built-in skills: playwright, playwright-cli, agent-browser, dev-browser, git-master, frontend-ui-ux. See references/skills.md.

Slash commands

/ralph-loop, /ulw-loop, /start-work, /refactor, /init-deep, /handoff, /cancel-ralph, /stop-continuation. See references/commands.md.

MCPs

Built-in MCP servers: websearch (Exa), context7 (docs), grep_app (GitHub code search). See references/mcps.md.

Security and privacy

OmO runs locally as an OpenCode plugin
No data is sent to oh-my-openagent servers
Model API calls go directly to the configured providers (GitHub Copilot, Google, OpenAI, etc.)
Config files are stored locally in ~/.config/opencode/
Auth tokens are stored in ~/.local/share/opencode/auth.json

Oh-my-openagent

安装技能