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 • CLI Reference • Workflows • 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.

Not Sure Where to Start?

If you're uncertain about requirements, have a vague idea, or want to micromanage the design:

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

The deep interview uses Socratic questioning to clarify your thinking before any code is written. It exposes hidden assumptions and measures clarity across weighted dimensions, ensuring you know exactly what to build before execution begins.

Team Mode (Recommended)

Starting in v4.1.7, Team is the canonical orchestration surface in OMC. The legacy swarm keyword/skill has been removed; use team directly.

/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 the CLI-first Team runtime (omc team ...) to spawn real tmux worker panes:

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

/omc-teams remains as a legacy compatibility skill and now routes to omc team ....

For mixed Codex + Gemini work in one command, use the /ccg skill (routes via ask-codex + ask-gemini, then Claude synthesizes):

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

Surface	Workers	Best For
`omc team N:codex "..."`	N Codex CLI panes	Code review, security analysis, architecture
`omc team N:gemini "..."`	N Gemini CLI panes	UI/UX design, docs, large-context tasks
`omc team N:claude "..."`	N Claude CLI panes	General tasks via Claude CLI in tmux
`/ccg`	ask-codex + ask-gemini	Tri-model advisor synthesis

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.

oh-my-claudecode

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
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 Claude agents on a shared task list
omc team (CLI)	tmux CLI workers — real `claude`/`codex`/`gemini` processes in split-panes	Codex/Gemini CLI tasks; on-demand spawn, die when done
ccg	Tri-model advisors via ask-codex + ask-gemini, Claude synthesizes	Mixed backend+UI work needing both Codex and Gemini
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
Ultrapilot (legacy)	Deprecated compatibility mode (autopilot pipeline alias)	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, team 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	`/team 3:executor "fix all TypeScript errors"`
`omc team`	tmux CLI workers (codex/gemini/claude)	`omc team 2:codex "security review"`
`ccg`	ask-codex + ask-gemini synthesis	`/ccg review this PR`
`autopilot`	Full autonomous execution	`autopilot: build a todo app`
`ralph`	Persistence mode	`ralph: refactor auth`
`ulw`	Maximum parallelism	`ulw fix all errors`
`ralplan`	Iterative planning consensus	`ralplan this feature`
`deep-interview`	Socratic requirements clarification	`deep-interview "vague idea"`
`deepsearch`	Codebase-focused search routing	`deepsearch for auth middleware`
`ultrathink`	Deep reasoning mode	`ultrathink about this architecture`
`cancelomc`, `stopomc`	Stop active OMC modes	`stopomc`

Notes:

ralph includes ultrawork: when you activate ralph mode, it automatically includes ultrawork's parallel execution.
swarm compatibility alias has been removed; migrate existing prompts to /team syntax.
plan this / plan the keyword triggers were removed; use ralplan or explicit /oh-my-claudecode:omc-plan.

Utilities

Provider Advisor (`omc ask`)

Run local provider CLIs and save a markdown artifact under .omc/artifacts/ask/:

omc ask claude "review this migration plan"
omc ask codex --prompt "identify architecture risks"
omc ask gemini --prompt "propose UI polish ideas"
omc ask claude --agent-prompt executor --prompt "draft implementation steps"

Canonical env vars:

OMC_ASK_ADVISOR_SCRIPT
OMC_ASK_ORIGINAL_TASK

Phase-1 aliases OMX_ASK_ADVISOR_SCRIPT and OMX_ASK_ORIGINAL_TASK are accepted with deprecation warnings.

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)

Monitoring & Analytics

Use the HUD for live observability and omc for cost/session reporting:

HUD analytics preset: /oh-my-claudecode:hud setup then set "omcHud": { "preset": "analytics" }
Cost reports: omc cost daily|weekly|monthly
Session history/backfill: omc sessions, omc backfill
Raw logs: .omc/state/token-tracking.jsonl, .omc/state/agent-replay-*.jsonl

Notification Tags (Telegram/Discord/Slack)

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"
omc config-stop-callback slack --enable --webhook <url> --tag-list "<!here>,<@U1234567890>"

# 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>
Slack: supports <@MEMBER_ID>, <!channel>, <!here>, <!everyone>, <!subteam^GROUP_ID>
file callbacks ignore tag options

Documentation

Full Reference - Complete feature documentation
CLI Reference - All omc commands, flags, and tools
Notifications Guide - Discord, Telegram, Slack, and webhook setup
Recommended Workflows - Battle-tested skill chains for common tasks
Release Notes - What's new in each version
Website - Interactive guides and examples
Migration Guide - Upgrade from v2.x
Architecture - How it works under the hood
Performance Monitoring - Agent tracking, debugging, and optimization

Requirements

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

Platform & tmux

OMC features like omc team and rate-limit detection require tmux:

Platform	tmux provider	Install
macOS	tmux	`brew install tmux`
Ubuntu/Debian	tmux	`sudo apt install tmux`
Fedora	tmux	`sudo dnf install tmux`
Arch	tmux	`sudo pacman -S tmux`
Windows	psmux (native)	`winget install psmux`
Windows (WSL2)	tmux (inside WSL)	`sudo apt install tmux`

Windows users: psmux provides a native tmux binary for Windows with 76 tmux-compatible commands. No WSL required.

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 • Ouroboros

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

Yeachan-Heo / oh-my-claudecode

AI Architecture Analysis

Embed this Badge

Repository Summary (README)

oh-my-claudecode

Quick Start

Not Sure Where to Start?

Team Mode (Recommended)

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

Updating

Your Claude Just Have been Steroided.

Why oh-my-claudecode?

Features

Orchestration Modes

Intelligent Orchestration

Developer Experience

Magic Keywords

Utilities

Provider Advisor (`omc ask`)

Rate Limit Wait

Monitoring & Analytics

Notification Tags (Telegram/Discord/Slack)

Documentation

Requirements

Platform & tmux

Optional: Multi-AI Orchestration

License

Star History

💖 Support This Project

Why sponsor?

Other ways to help

AI Architecture Analysis

Embed this Badge

Repository Summary (README)

oh-my-claudecode

Quick Start

Not Sure Where to Start?

Team Mode (Recommended)

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

Updating

Your Claude Just Have been Steroided.

Why oh-my-claudecode?

Features

Orchestration Modes

Intelligent Orchestration

Developer Experience

Magic Keywords

Utilities

Provider Advisor (omc ask)

Rate Limit Wait

Monitoring & Analytics

Notification Tags (Telegram/Discord/Slack)

Documentation

Requirements

Platform & tmux

Optional: Multi-AI Orchestration

License

Star History

💖 Support This Project

Why sponsor?

Other ways to help

Provider Advisor (`omc ask`)