Oh My Codex (OMX) is a workflow and runtime layer for the OpenAI Codex CLI. It does not replace Codex: Codex still does the agent work, while OMX adds reusable role keywords, workflow skills, project guidance through scoped AGENTS.md files, and a per-project state directory for plans, logs, memory, and mode tracking.
Its default workflow runs from clarification to completion in stages. A deep-interview skill clears ambiguity through Socratic questioning and writes requirements artifacts, ralplan produces an architecture and consensus plan, and ultragoal executes the approved plan as durable multi-goal work with ledger checkpoints. An autopilot orchestrator chains the three, and each stage can also be invoked on its own.
For parallel work, the team runtime coordinates several Codex workers through tmux, giving each worker its own git worktree and integrating their commits back into the leader through merge, cherry-pick, or rebase. A HUD shows each worker's state, task, and role. OMX targets macOS and Linux, and native Windows and the Codex App are less supported.
Features
- Staged workflow: deep-interview, ralplan, and ultragoal take a task from clarification through planning to durable completion
- Team runtime: parallel Codex workers in tmux, each in an isolated git worktree, with incremental merge tracking and conflict reports
- Durable state: plans, logs, memory, and mode tracking persist per project so long tasks survive across sessions
- HUD: a live status view of active teams and each worker's state, current task, role, and pane
- Worktree launches: sessions can start in a named git worktree, which keeps sandbox-bypassing runs away from the main checkout
- Mission runner: runs a checklist of prompts in sequence with a durable summary and ledger
- Codex plugin and hooks: an official Codex plugin layout with lifecycle hooks, plus managed native Codex hooks for older installs
- Sparkshell: shell-native inspection and bounded verification with model-generated summaries of command output
- Project wiki: a markdown-first, search-first knowledge base stored in the repository and queried through the CLI
- Doctor and smoke test: an install check plus an execution test that confirms Codex can authenticate and complete a model call
