oh-my-codex

cmux omx launches Oh My Codex (OMX) in a cmux-aware environment. OMX is a multi-agent orchestration layer for OpenAI Codex CLI with 30+ specialized agent roles, workflow skills, and tmux-based parallel team execution. When OMX spawns team panes or HUD displays, they become native cmux splits.

Usage

cmux omx
cmux omx --madmax --high
cmux omx team

All arguments after omx are forwarded to the omx CLI.

What you get

OMX's team mode and HUD use tmux for pane management. With cmux omx, those panes become native cmux splits:

• Team worker panes (Codex/Claude sessions) appear as cmux splits in the workspace
• HUD status display shows model, branch, context, and token usage in a split pane
• Auto-layout management arranges agent panes in a main-vertical grid
• Your main session stays in the primary pane while workers operate beside it

Prerequisites

npm install -g @openai/codex oh-my-codex
omx setup
omx doctor

OMX requires OpenAI Codex CLI and a working Codex auth setup. Run omx doctor to verify your installation.

How it works

Same pattern as other cmux agent integrations. A tmux shim intercepts tmux commands from OMX and translates them into cmux API calls.

• Creates a tmux shim at ~/.cmuxterm/omx-bin/tmux that redirects to cmux __tmux-compat
• Sets TMUX and TMUX_PANE to simulate a tmux session
• Prepends the shim directory to PATH
• Execs into omx with all remaining arguments forwarded

Directories

Environment variables