Oh My Claudecode

Definition

Oh-My-ClaudeCode (OMC) is a multi-agent orchestration system for Claude Code with a zero learning curve. It stands out for Team mode (a canonical staged pipeline), multi-provider orchestration (Claude + Codex + Gemini), a deep interview system, and persistent execution modes. NPM package: oh-my-claude-sisyphus.

Team mode runs a shared task from plan to PRD, then exec, verify, and fix. One mode runs a tmux team of Claude, Codex, and Gemini workers. Others cover tri-model synthesis, a single lead autopilot, a parallel burst, a persistent verify and fix loop, and staged processing. The deep interview asks questions until the request is clearer.

Basic Information

Installation

Plugin Marketplace (Recommended)

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

NPM

npm i -g oh-my-claude-sisyphus@latest

Setup

/setup        # Inside Claude Code session
omc setup     # From terminal

Core Orchestration Modes

Key Features

Team Mode (Canonical)

/team 3:executor "fix all TypeScript errors"

Staged pipeline: plan -> PRD -> exec -> verify -> fix (loop)

Enable Claude Code native teams:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

tmux CLI Workers (v4.4.0+)

omc team 2:codex "review auth module"
omc team 2:gemini "redesign UI components"
omc team 1:claude "implement payment flow"
omc team status auth-review
omc team shutdown auth-review

Workers spawn on demand and die when the task completes.

Deep Interview

/deep-interview "I want to build a task management app"

Socratic questioning to clarify your thinking before coding. Measures clarity across weighted dimensions.

19 Specialized Agents

Smart model routing: Haiku for simple tasks, Opus for complex reasoning.

Custom Skills

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Wrap handler at server.py:42 in try/except ClientDisconnectedError...

Manage: /skill list | add | remove | edit | search Auto-learn: /learner extracts patterns

Provider Advisor

omc ask claude "review this migration plan"
omc ask codex "identify architecture risks"
omc ask gemini "propose UI polish ideas"

HUD Statusline

Real-time orchestration metrics in the status bar.

Notifications

Telegram, Discord, and Slack notifications when sessions stop:

omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id>
omc config-stop-callback discord --enable --webhook <url>
omc config-stop-callback slack --enable --webhook <url>

OpenClaw Integration

Forwards Claude Code session events to the OpenClaw gateway for automated responses.

Autoresearch

omc autoresearch --mission "improve startup performance" --eval "npm test"

Rate Limit Wait

omc wait          # Check status
omc wait --start  # Auto-resume daemon

In-Session Shortcuts

Requirements

Cost Estimate

3 Pro plans (Claude + Gemini + ChatGPT) = ~$60/month

Tech Stack

Pros

Cons

When to Use

• Multi-agent orchestration: Need a coordinated team of agents
• Cross-provider workflows: Want to combine Claude + Codex + Gemini
• Complex features: Need a staged plan -> exec -> verify pipeline
• Requirements clarification: Want a Socratic deep interview before coding
• Persistent execution: Want tasks to complete fully (Ralph mode)
• Large teams: Need shared skills and coordination

The page lists 19 specialized agents in tiers such as architecture, research, design, testing, data science, and executor. Simple tasks go to Haiku and complex reasoning goes to Opus. Project skills live in .omc/skills. User skills live in ~/.omc/skills and apply to every project. A HUD status line shows live orchestration metrics. Telegram, Discord, or Slack can report when a session stops. Cross-provider work needs Claude Code, a Max or Pro plan or an API key, and tmux. Three Pro plans, Claude plus Gemini plus ChatGPT, come to about 60 dollars a month. The npm package is named oh-my-claude-sisyphus, which does not match the repo name.

References:

• Yeachan-Heo/oh-my-claudecode
• npm: oh-my-claude-sisyphus
• Docs

See also: Kit Comparison · Multi Agent Systems · Everything Claude Code