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: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.

/omc: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.

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: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: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

Orchestration Modes

Multiple strategies for different use cases — from Team-backed orchestration to token-efficient refactoring. Learn more →

Mode	What it is	Use For
Team (recommended)	Canonical staged pipeline (team-plan → team-prd → team-exec → team-verify → team-fix)	Coordinated agents working on a shared task list
Autopilot	Autonomous execution (single lead agent)	End-to-end feature work with minimal ceremony
Ultrawork	Maximum parallelism (non-team)	Burst parallel fixes/refactors where Team isn't needed
Ralph	Persistent mode with verify/fix loops	Tasks that must complete fully (no silent partials)
Pipeline	Sequential, staged processing	Multi-step transformations with strict ordering
Swarm / Ultrapilot (legacy)	Compatibility facades that route to Team	Existing workflows and older docs

Intelligent Orchestration

• 32 specialized agents for architecture, research, design, testing, data science
• Smart model routing - Haiku for simple tasks, Opus for complex reasoning
• Automatic delegation - Right agent for the job, every time

Developer Experience

• Magic keywords - ralph, ulw, plan for explicit control
• HUD statusline - Real-time orchestration metrics in your status bar
• Skill learning - Extract reusable patterns from your sessions
• Analytics & cost tracking - Understand token usage across all sessions

Full feature list →

---

Magic Keywords

Optional shortcuts for power users. Natural language works fine without them.

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 keyword (routes to Team)	swarm 5 agents: fix lint errors
ultrapilot	Legacy keyword (routes to Team)	ultrapilot: build a fullstack app

Notes:

• ralph includes ultrawork: when you activate ralph mode, it automatically includes ultrawork's parallel execution.
• swarm N agents syntax is still recognized for agent count extraction, but the runtime is Team-backed in v4.1.7+.

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

Requires: tmux (for session detection)

Notification Tags (Telegram/Discord)

You can configure who gets tagged when stop callbacks send session summaries.

# Set/replace tag list
omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678,role:987654321098765432"

# Incremental updates
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

Tag behavior:

• Telegram: alice becomes @alice
• Discord: supports @here, @everyone, numeric user IDs, and role:<id>
• file callbacks ignore tag options

---

Documentation

• Full Reference - Complete feature documentation
• Performance Monitoring - Agent tracking, debugging, and optimization
• Website - Interactive guides and examples
• Migration Guide - Upgrade from v2.x
• Architecture - How it works under the hood

---

Requirements

• Claude Code CLI
• Claude Max/Pro subscription OR Anthropic API key

Optional: Multi-AI Orchestration

OMC can optionally orchestrate external AI providers for cross-validation and design consistency. These are not required — OMC works fully without them.

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

Cost: 3 Pro plans (Claude + Gemini + ChatGPT) cover everything for ~$60/month.

---

License

MIT

---

Inspired by: oh-my-opencode • claude-hud • Superpowers • everything-claude-code

Zero learning curve. Maximum power.

Star History

💖 Support This Project

If Oh-My-ClaudeCode helps your workflow, consider sponsoring:

Why sponsor?

• Keep development active
• Priority support for sponsors
• Influence roadmap & features
• Help maintain free & open source

Other ways to help

• ⭐ Star the repo
• 🐛 Report bugs
• 💡 Suggest features
• 📝 Contribute code