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 setup leaves `model_context_window` and `model_auto_compact_token_limit` unset so Codex uses the active model defaults. Rerunning setup removes only unchanged legacy values proven to have been seeded by OMX and preserves explicit, unmarked, and edited values.

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

- CLI-first MCP taxonomy and recovery matrix
- .omx-config.json model/env routing reference
- GitHub / PR / package identity pipeline

## Integration Guides

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

Open dedicated Integrations page

- Discord setup: webhook URL vs bot token
- English
- 한국어
- 日本語
- 简体中文
- 繁體中文
- Tiếng Việt
- Español
- Português
- Русский
- Türkçe
- Deutsch
- Français
- Italiano
- Українська

## 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)