Your Codex CLI needed a workflow layer
OMX wraps OpenAI's Codex CLI in a structured workflow that forces clarification before execution.

What it does
OMX is an orchestration layer that wraps OpenAI’s Codex CLI without replacing it. It enforces a structured pipeline—$deep-interview for clarification, $ralplan for planning, and $ultragoal for durable execution—while keeping project guidance, logs, and memory in a local .omx/ directory. Essentially, it adds a project manager and a filing cabinet to a very eager intern.
The interesting bit
The clever part is the safety plumbing around reckless speed. OMX integrates with git worktrees to isolate sessions, particularly when running with --madmax (which bypasses Codex’s approval sandbox), and uses tmux to maintain persistent HUD panes so long-running agent teams survive terminal closures.
Key highlights
- Canonical workflow commands (
$deep-interview,$ralplan,$ultragoal) force the AI to clarify, plan, then execute - Durable state management under
.omx/for plans, memory, and mode tracking tmux-based persistent runtime with HUD panes for concurrent agent teams- Git worktree integration provides checkout isolation for high-risk or concurrent sessions
- Ships as both a global CLI and an official Codex plugin, though the plugin relies on the installed CLI rather than replacing it
Caveats
- Native Windows and the Codex App are explicitly unsupported second-class citizens; the project is “primarily designed and actively tuned” for macOS and Linux with Codex CLI
Verdict
Reach for OMX if you want Codex to stop freelancing and follow a rigorous clarify-plan-execute protocol. If you are happy with plain Codex or develop primarily on Windows, you probably do not need this layer.
Frequently asked
- What is Yeachan-Heo/oh-my-codex?
- OMX wraps OpenAI's Codex CLI in a structured workflow that forces clarification before execution.
- Is oh-my-codex open source?
- Yes — Yeachan-Heo/oh-my-codex is an open-source project tracked on heatdrop.
- What language is oh-my-codex written in?
- Yeachan-Heo/oh-my-codex is primarily written in TypeScript.
- How popular is oh-my-codex?
- Yeachan-Heo/oh-my-codex has 32.2k stars on GitHub and is currently accelerating.
- Where can I find oh-my-codex?
- Yeachan-Heo/oh-my-codex is on GitHub at https://github.com/Yeachan-Heo/oh-my-codex.