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.13.1 Latest Release ★ — Stars ↓ — Downloads/mo ⚡ 33 Prompts 🎯 36 Skills 🤝 Team Mode 🔌 5 MCP Servers

Get Started Read Docs View on GitHub

v0.13.1 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.

Native Codex Hook Ownership

Non-team OMX sessions now wire hooks natively through the Codex runtime contract, removing the need for external shims and ensuring hooks fire reliably on every tool call.

First-Party Bash Guidance

Shipped PreToolUse and PostToolUse Bash hooks with first-party documentation. Destructive commands trigger warnings; errors surface structured guidance automatically.

Team Runtime Hardening

Leader mailbox delivery, pane-status visibility, nudge handling, session continuity, and persist-error paths are all more robust across live operator flows.

Windows/tmux Reliability

Detached tmux launches, PowerShell command resolution, and tmux child binding are all improved. Worktree supervision stays stable across Windows and remote sessions.

Quality-First Defaults

Prompt and AGENTS defaults now emphasize quality-first, evidence-backed execution. The canonical workflow — deep-interview → ralplan → team/ralph — is documented and enforced.

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"

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.

Step 1: Install via npm

npm install -g oh-my-codex

Step 2: Setup and verify

omx setup && omx doctor

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"