oh-my-codex

Your codex is not alone.

Multi-agent orchestration layer for OpenAI Codex CLI. Build faster with staged team pipelines, persistent memory/state MCP servers, and extensible hooks.

🚀 v0.18.8 Latest Release ★ — Stars ↓ — Downloads/mo ⚡ 33 Prompts 🎯 37 Skills 🤝 Team Mode 🔌 5 MCP Servers

Get Started Read Docs Vibetip Docs View on GitHub

Recommended Workflow

# 1. Launch interactive Codex session
$ omx --madmax --high

# 2. Use keywords inside Codex for workflows
$deep-interview "clarify the auth change"
$ralplan "approve the implementation plan"
$ralph "carry the plan to completion"

Launch omx --madmax --high

Start the interactive Codex session with recommended settings for trusted environments.

Clarify $deep-interview

Use inside Codex when intent or boundaries are still unclear. Socratic clarification before planning.

Execute $ralph or $team

Choose $ralph for persistent completion loops, or $team for coordinated parallel execution.

Durable HUD Ownership

HUD panes are scoped by leader/source pane, duplicate legacy panes are deduped after prompt revive, deleted-cwd doctor panes are avoided, escaped tmux separators parse correctly, and native session-id drift preserves ownership.

Safer Autopilot Replay

Completed terminal turns no longer reactivate Autopilot, context snapshots are seeded and hardened, task-seed provenance is clearer, and planning phases avoid editing under native session drift.

Stricter Plugin Hooks

Stale plugin hook cache refresh is fixed, setup mode survives update refresh, launcher JSON fallback behavior is preserved, and mirror sync verifies plugin hook metadata.

Clearer Team Runtime

Team mode can be disabled, tmux worktree startup compatibility is fixed, native executor lanes remain leaf-only, and default native subagent routing guidance is corrected.

Tighter Release Evidence

Self-hosted Linux runner selection and GJC evidence lane optimization reduce avoidable CI churn while release readiness records local, e2e, live, pack, and publication gates.

Automatic Worktree Isolation

Every worker gets a dedicated git worktree at .omx/team/<name>/worktrees/worker-N. No --worktree flag needed — it's the default. Workers write to isolated detached branches; the leader workspace stays clean.

Incremental Merge Tracking

The leader continuously integrates worker commits via merge, cherry-pick, or cross-worker rebase strategies. Conflicts are detected early and reported in integration-report.md. Auto-commit ensures no work is lost.

Mixed-Provider Teams

Run Codex, Claude, and Gemini workers side-by-side with OMX_TEAM_WORKER_CLI_MAP. Each worker gets its own worktree regardless of provider. Full staged pipeline: plan → exec → verify → fix.

$team — Worktree Lifecycle

# Use $team inside Codex (recommended)
$team 3:executor "refactor auth module"
Team started: refactor-auth-module
workers: 3 (worktrees: automatic, detached)

# Advanced: CLI operator surface
omx team 3:executor "refactor auth module"
omx team status refactor-auth-module

# Mixed providers with worktrees
OMX_TEAM_WORKER_CLI_MAP=codex,claude,gemini \
  omx team 3:executor "full-stack implementation"

Role Prompts

33 specialized prompts via /prompts:name for targeted expertise across implementation, review, domain, and coordination lanes.

Workflow Skills

37 workflow skills and command surfaces via $name syntax for autopilot, team orchestration, planning, recovery, and QA cycles.

Team Orchestration

Isolated parallel execution with automatic git worktrees. Workers get dedicated worktrees by default — zero merge conflicts, automatic commit integration, and incremental merge tracking.

MCP Servers

State, memory, code intelligence, and trace servers (5 total) for persistent context and cross-session learning.

Staged Pipeline

plan → prd → exec → verify → fix lifecycle for structured, evidence-based development workflows.

Launch Profiles

--yolo, --high, --xhigh, --madmax modes for granular control over reasoning effort and execution intensity.

Step 1: Install via npm

npm install -g @openai/codex
npm install -g oh-my-codex

Step 2: Setup and verify

omx setup && omx doctor

Step 3: Launch and work

omx --madmax --high

Core Development

architect planner executor debugger verifier explore

Quality Assurance

style-reviewer quality-reviewer api-reviewer security-reviewer performance-reviewer

Domain Experts

dependency-expert test-engineer build-fixer designer writer qa-tester

Product Strategy

product-manager ux-researcher product-analyst information-architect

Keyword	Skill Name	Description
`autopilot`	autopilot	Full autonomous execution from idea to working code
`ralph`	ralph	Self-referential loop with verifier verification until completion
`ulw`	ultrawork	Maximum parallelism with parallel agent orchestration
`team`	team	N coordinated agents using Codex CLI native teams
`plan`	plan	Strategic planning with consensus and review modes
`research`	research	Parallel scientist agents for comprehensive research
`cancel`	cancel	Stop execution modes and clear active state
`tdd`	tdd	Test-first development with red-green-refactor cycle
`build-fix`	build-fix	Fix build errors, type errors, and toolchain failures
`code-review`	code-review	Comprehensive code review across all quality dimensions
`security-review`	security-review	Security audit focusing on vulnerabilities and trust boundaries

Webhook Integration

Easily send build status, test results, and agent updates to your Discord channels using the configure-notifications skill.

            Skill
          
            "configure discord webhook"

Bot Interaction

Deploy custom bots to listen for commands, trigger workflows, and provide interactive feedback directly within your Discord server.

            Skill
          
            "setup discord bot"

Unified Delivery

Send notifications to Discord, Slack, Telegram, and custom webhooks through a single OpenClaw gateway. Intelligent routing ensures messages reach the right channel.

Status Signaling

Reliable delivery confirmation with retry logic. Track notification status in real-time and ensure critical alerts never get lost.

Bot Notifications

Configure your Telegram bot to receive build updates, deployment notifications, and agent status messages directly in your chat.

            Skill
          
            "configure telegram notifications"

Command Interface

Control your Codex agents via Telegram messages. Start workflows, check status, and receive summaries without leaving your mobile device.

            Skill
          
            "setup telegram commands"