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