omc (oh-my-claudecode) — Claude Code Multi-Agent Orchestration
When to use this skill
- You want Teams-first multi-agent orchestration inside Claude Code
- You need 32 specialized agents with smart model routing (Haiku → Opus)
- Complex tasks that benefit from parallel agent execution with verification loops
- Any Claude Code workflow that needs persistent, guaranteed-completion execution
1. Installation (3 Steps)
Step 1: Install plugin
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecodeStep 2: Run setup
/omc:omc-setupStep 3: Build something
autopilot: build a REST API for managing tasksnpm alternative: npm install -g oh-my-claude-sisyphus2. Orchestration Modes
| Mode | What it is | Use For |
|---|---|---|
| Team (recommended) | Staged pipeline: team-plan → team-prd → team-exec → team-verify → team-fix | Coordinated agents on shared task list |
| Autopilot | Autonomous single lead agent | End-to-end feature work with minimal ceremony |
| Ultrawork | Maximum parallelism (non-team) | Burst parallel fixes/refactors |
| Ralph | Persistent mode with verify/fix loops | Tasks that must complete fully |
| Pipeline | Sequential staged processing | Multi-step transformations |
| Swarm/Ultrapilot | Legacy facades → route to Team | Existing workflows |
Enable Claude Code native teams in ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}3. Magic Keywords
| Keyword | Effect | Example |
|---|---|---|
team | Canonical Team orchestration | /omc:team 3:executor "fix all TypeScript errors" |
autopilot | Full autonomous execution | autopilot: build a todo app |
ralph | Persistence mode | ralph: refactor auth |
ulw | Maximum parallelism | ulw fix all errors |
plan | Planning interview | plan the API |
ralplan | Iterative planning consensus | ralplan this feature |
swarm | Legacy (routes to Team) | swarm 5 agents: fix lint errors |
ultrapilot | Legacy (routes to Team) | ultrapilot: build a fullstack app |
Note: ralph includes ultrawork — activating ralph mode automatically includes ultrawork's parallel execution.4. Team Mode (Canonical)
/omc:team 3:executor "fix all TypeScript errors"Runs as a staged pipeline:
team-plan → team-prd → team-exec → team-verify → team-fix (loop)5. Utilities
Rate Limit Wait
Auto-resume Claude Code sessions when rate limits reset:
omc wait # Check status, get guidance
omc wait --start # Enable auto-resume daemon
omc wait --stop # Disable daemonNotifications (Telegram/Discord)
omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id>
omc config-stop-callback discord --enable --webhook <url>6. Updating
# 1. Sync latest version
/plugin marketplace update omc
# 2. Re-run setup
/omc:omc-setup
# If issues after update
/omc:omc-doctor7. Optional: Multi-AI Orchestration
OMC can optionally orchestrate external AI providers (not required):
| Provider | Install | What it enables |
|---|---|---|
| Gemini CLI | npm install -g @google/gemini-cli | Design review, UI consistency (1M token context) |
| Codex CLI | npm install -g @openai/codex | Architecture validation, code review cross-check |
Why OMC?
- Zero configuration — works out of the box with intelligent defaults
- Team-first orchestration — Team is the canonical multi-agent surface
- Natural language interface — no commands to memorize
- Automatic parallelization — complex tasks distributed across 32 specialized agents
- Persistent execution — won't stop until the job is verified complete
- Cost optimization — smart model routing saves 30–50% on tokens
- Real-time visibility — HUD statusline shows what's happening under the hood
Quick Reference
| Action | Command |
|---|---|
| Install | /plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode |
| Setup | /omc:omc-setup |
| Team mode | /omc:team N:executor "task" |
| Autopilot | autopilot: <task> |
| Ralph loop | ralph: <task> |
| Ultrawork | ulw <task> |
| Update | /plugin marketplace update omc && /omc:omc-setup |
| Debug | /omc:omc-doctor |