oh-my-claudecode

English | [한국어](README.ko.md) | [中文](README.zh.md) | [日本語](README.ja.md) | [Español](README.es.md) | [Tiếng Việt](README.vi.md) | [Português](README.pt.md) # oh-my-claudecode [](https://www.npmjs.com/package/oh-my-claude-sisyphus) [](https://www.npmjs.com/package/oh-my-claude-sisyphus) [](https://github.com/Yeachan-Heo/oh-my-claudecode/stargazers) [](https://opensource.org/licenses/MIT) [](https://github.com/sponsors/Yeachan-Heo) [](https://discord.gg/qRJw62Gvh7) > **For Codex users:** Check out [oh-my-codex](https://github.com/Yeachan-Heo/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](#quick-start) • [Documentation](https://yeachan-heo.github.io/oh-my-claudecode-website) • [CLI Reference](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#cli-reference) • [Workflows](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#workflows) • [Migration Guide](docs/MIGRATION.md) • [Discord](https://discord.gg/qRJw62Gvh7) --- ## Quick Start **Step 1: Install** ```bash /plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode /plugin install oh-my-claudecode ``` **Step 2: Setup** ```bash /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. ```bash /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`: ```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: ```bash 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): ```bash /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`](https://www.npmjs.com/package/oh-my-claude-sisyphus). If you install or upgrade the CLI tools via npm/bun, use `npm i -g oh-my-claude-sisyphus@latest`. ### Updating If you installed OMC via npm, upgrade with the published package name: ```bash npm i -g oh-my-claude-sisyphus@latest ``` > **Package naming note:** the repo, plugin, and commands are branded **oh-my-claudecode**, but the published npm package name remains `oh-my-claude-sisyphus`. If you installed OMC via the Claude Code marketplace/plugin flow, update with: ```bash # 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: ```bash /omc-doctor ``` <h1 align="center">Your Claude Just Have been Steroided.</h1> <p align="center"> <img src="assets/omc-character.jpg" alt="oh-my-claudecode" width="400" /> </p> --- ## 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 →](https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#execution-modes) | 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 | Ta