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