← all repositories
Yeachan-Heo/oh-my-codex

Your Codex CLI needed a workflow layer

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

32.2k stars TypeScript Coding AssistantsAgents
oh-my-codex
Velocity · 7d
+124
★ / day
Trend
accelerating
star history

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.