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.10.0 Latest Release ★ — Stars ↓ — Downloads/mo ⚡ 33 Prompts 🎯 36 Skills 🤝 Team Mode 🔌 5 MCP Servers
Get Started Read Docs View on GitHub
v0.10.0 Command Surface 
$ omx autoresearch "how does the auth middleware work?"
$ omx exec npm test -- --coverage
$ omx team 3 "refactor auth module with full test coverage"
Autonomous Research omx autoresearch

Iteratively explores topics, synthesizes findings, and produces structured reports.

Orchestration Wrapper omx exec

Run any command through the OMX orchestration layer with hooks, state, and logging.

Team Worktrees omx team

Team workers get isolated git worktrees automatically for conflict-free parallel work.

oh-my-codex character illustration

v0.10.0

Released: March 15, 2026 — 54 commits, 26 PRs, 105 files changed. Autonomous research, orchestration wrapper, team worktrees, intent-first interviews, and incremental merge tracking.

Autonomous Research

omx autoresearch launches an autonomous research loop that iteratively explores a topic, refines questions, and synthesizes findings across multiple iterations.

OMX Exec Wrapper

omx exec runs any command through the OMX orchestration layer, applying hooks, state tracking, and structured logging automatically.

Team Worktrees by Default

Team workers now get isolated git worktrees automatically, enabling conflict-free parallel development without manual branch management.

Deep-Interview Intent-First

Intent classification now happens upfront before the Socratic loop, so deep interviews route to the right workflow faster with less back-and-forth.

Incremental Merge Tracking

Smarter conflict detection tracks worktree changes incrementally, catching merge issues earlier and reducing manual resolution overhead.

$team — Worktree-First Parallel Execution

The core OMX skill. Since v0.10.0, every team worker runs in an isolated git worktree by default — no flags needed, no merge conflicts, automatic integration.

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 
# Workers get worktrees automatically — no flags needed
$ omx team 3:executor "refactor auth module"
Team started: refactor-auth-module
workers: 3 (worktrees: automatic, detached)

$ omx team status refactor-auth-module
worker-1: worktree=.omx/team/.../worker-1  status=in_progress
worker-2: worktree=.omx/team/.../worker-2  status=completed
worker-3: worktree=.omx/team/.../worker-3  status=completed
tasks: completed=2 in_progress=1
integration: merged=2 conflicts=0

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

Features

Everything you need for autonomous software development with OpenAI Codex CLI

Role Prompts

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

Workflow Skills

36 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.

Installation

Get up and running in seconds with npm

Step 1: Install via npm
npm install -g oh-my-codex
Step 2: Setup and verify
omx setup && omx doctor

Agent Tiers

33 specialized prompts organized by domain, review depth, and orchestration responsibility

Build/Analysis

Core Development

architect planner executor debugger verifier explore
Review Lane

Quality Assurance

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

Domain Experts

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

Product Strategy

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

Skills

Repeatable workflows triggered by keywords or $syntax

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

Discord Integration

Seamlessly connect your Codex workflows with Discord for real-time notifications and team collaboration.

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"

OpenClaw Gateway

Unified outbound delivery for all your notification channels with intelligent routing and status signaling.

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.

Telegram Integration

Connect your Codex workflows to Telegram for instant mobile notifications and bot interactions.

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"