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