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.4.0 Latest Release ★ — Stars ↓ — Downloads/mo ⚡ 30 Agents 🎯 40+ Skills 🤝 Team Mode 🔌 4 MCP Servers
Get Started View on GitHub
oh-my-codex character illustration

What’s New in v0.4.0

This release hardens day-to-day execution and expands extension points for custom workflows.

Hook Extensions

Add custom plugin handlers with omx hooks (init/status/validate/test) and opt-in event dispatch.

Native Lifecycle Events

Native hooks now emit structured events across session start/end/idle and turn completion flows.

tmux Reliability

Submit behavior is standardized to C-m for more consistent execution in tmux-based automation.

Features

Everything you need for autonomous software development with OpenAI Codex CLI

Role Prompts

30 specialized agent prompts via /prompts:name for targeted expertise across every development domain.

Workflow Skills

40+ repeatable execution modes via $name syntax for autopilot, team orchestration, planning, and QA cycles.

Team Orchestration

Parallel workers in tmux sessions via omx team for coordinated multi-agent task execution.

MCP Servers

State, memory, code intelligence, and trace servers 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

30 specialized agents organized by domain and expertise

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