oh-my-claudecode

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português

oh-my-claudecode

For Codex users: Check out oh-my-codex — the same orchestration experience for OpenAI Codex CLI.

Multi-agent orchestration for Claude Code. Zero learning curve.

Don't learn Claude Code. Just use OMC.

Get Started • Documentation • Migration Guide

---

Quick Start

Step 1: Install

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

Step 2: Setup

/omc-setup

Step 3: Build something

autopilot: build a REST API for managing tasks

That's it. Everything else is automatic.

Team Mode (Recommended)

Starting in v4.1.7, Team is the canonical orchestration surface in OMC. Legacy entrypoints like swarm and ultrapilot are still supported, but they now route to Team under the hood.

/team 3:executor "fix all TypeScript errors"

Team runs as a staged pipeline:

team-plan → team-prd → team-exec → team-verify → team-fix (loop)

Enable Claude Code native teams in ~/.claude/settings.json:

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

If teams are disabled, OMC will warn you and fall back to non-team execution where possible.

tmux CLI Workers — Codex & Gemini (v4.4.0+)

v4.4.0 removes the Codex/Gemini MCP servers (x, g providers). Use /omc-teams to spawn real CLI processes in tmux split-panes instead:

/omc-teams 2:codex   "review auth module for security issues"
/omc-teams 2:gemini  "redesign UI components for accessibility"
/omc-teams 1:claude  "implement the payment flow"

For mixed Codex + Gemini work in one command, use the /ccg skill:

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

Skill	Workers	Best For
/omc-teams N:codex	N Codex CLI panes	Code review, security analysis, architecture
/omc-teams N:gemini	N Gemini CLI panes	UI/UX design, docs, large-context tasks
/omc-teams N:claude	N Claude CLI panes	General tasks via Claude CLI in tmux
/ccg	1 Codex + 1 Gemini	Parallel tri-model orchestration

Workers spawn on-demand and die when their task completes — no idle resource usage. Requires codex / gemini CLIs installed and an active tmux session.

Note: Package naming — The project is branded as oh-my-claudecode (repo, plugin, commands), but the npm package is published as oh-my-claude-sisyphus. If you install the CLI tools via npm/bun, use npm install -g oh-my-claude-sisyphus.

Updating

# 1. Update the marketplace clone
/plugin marketplace update omc

# 2. Re-run setup to refresh configuration
/omc-setup

Note: If marketplace auto-update is not enabled, you must manually run /plugin marketplace update omc to sync the latest version before running setup.

If you experience issues after updating, clear the old plugin cache:

/omc-doctor

Your Claude Just Have been Steroided.

---

Why oh-my-claudecode?

• Zero configuration required - Works out of the box with intelligent defaults
• Team-first orchestration - Team is the canonical multi-agent surface (swarm/ultrapilot are compatibility facades)
• Natural language interface - No commands to memorize, just describe what you want
• Automatic parallelization - Complex tasks distributed across specialized agents
• Persistent execution - Won't give up until the job is verified complete
• Cost optimization - Smart model routing saves 30-50% on tokens
• Learn from experience - Automatically extracts and reuses problem-solving patterns
• Real-time visibility - HUD statusline shows what's happening under the hood

---

Features