GitHub Pages

oh-my-codex

Multi-agent orchestration for OpenAI Codex CLI.

Official project: Yeachan-Heo/oh-my-codex. Official package: oh-my-codex. Third-party projects or forks using names such as “OMX v2” are not official continuations or release lines unless these docs explicitly say so.

npm install -g oh-my-codex

Real global version bumps now print an explicit reminder instead of auto-launching omx setup. When you're ready, run omx setup manually or use omx update to check npm and then run the same setup refresh path. Launch-time update checks are throttled and prompt by default; set OMX_AUTO_UPDATE=0 to disable them or OMX_AUTO_UPDATE=defer to schedule deferred updates without prompting. Fresh OMX-managed gpt-5.5 configs recommend 250000 / 200000 only when those keys are missing.

What's New in 0.6.0

Mixed Codex + Claude teammates

Route workers per pane with OMX_TEAM_WORKER_CLI_MAP (for example: codex,codex,claude,claude) so one $team run can use both CLIs.

Claude-team leader nudges

Added a leader-side all-workers-idle fallback so notifications still fire even when worker-side Codex hooks are unavailable.

Safer trigger retries

Team trigger fallback now gates adaptive resend behind a ready prompt and no-active-task check, with safer clear-line resend behavior.

Reliability fixes

Improved task-claim bootstrap, stricter CLI map validation, predictable auto resolution, and better leader pane targeting for mixed/Claude teams.

Core Features

Agent Prompts

Specialized roles for implementation, review, design, and planning.

Skills

Composable workflows from autopilot and team pipelines to setup, release, and tracing.

Team Orchestration

Staged execution pipeline with verification and fix loops.

MCP State Management

Persistent lifecycle state, notepad, and project memory across sessions.

Quick Start

  1. npm install -g oh-my-codex
  2. After install or real version bumps, run omx setup yourself when you're ready, or use omx update when you also want npm to update OMX first.
  3. omx doctor
  4. omx --xhigh --madmax (trusted environments) or omx

Reference Guides

Integration Guides

OpenClaw / notification gateway setup and prompt-tuning guides by language:

Open dedicated Integrations page

Architecture

User
  -> Codex CLI
     -> AGENTS.md (orchestration brain)
     -> ~/.codex/prompts/*.md (installable active/internal agent prompt catalog)
     -> ~/.codex/skills/*/SKILL.md (skill catalog)
     -> ~/.codex/config.toml (features, notify, MCP)
     -> .omx/ (runtime state, memory, plans, logs)