omc

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-claudecode

Step 2: Run setup

/omc:omc-setup

Step 3: Build something

autopilot: build a REST API for managing tasks

npm alternative: npm install -g oh-my-claude-sisyphus

2. 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 daemon

Notifications (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-doctor

7. 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 |

→ Full documentation · GitHub