Yeachan-Heo/oh-my-codex
OmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.
What it solves
OMX (oh-my-codex) acts as a workflow and orchestration layer for the OpenAI Codex CLI. It addresses the need for a more structured, persistent, and repeatable development environment when using Codex, helping users manage complex tasks through standardized planning, multi-goal execution, and state tracking.
How it works
OMX wraps the existing Codex CLI, providing a set of specialized commands and a directory structure (.omx/) to maintain context. It introduces a canonical workflow—moving from Socratic clarification ($deep-interview) to architectural planning ($ralplan) and finally to durable, multi-goal execution ($ultragoal). It uses Git worktrees to isolate concurrent tasks and provides tools for managing project-specific guidance via AGENTS.md files.
Who it’s for
This tool is designed for developers who already use the OpenAI Codex CLI and want to improve their day-to-day productivity with better task routing, workflow automation, and session management. It is primarily optimized for macOS and Linux environments.
Highlights
- Structured Workflow: Provides a clear path from requirement gathering to execution using specialized commands like
$deep-interview,$ralplan, and$ultragoal. - State Persistence: Automatically stores plans, logs, and memory in a local
.omx/directory, allowing for resumable sessions. - Git Integration: Uses Git worktrees to safely isolate different tasks, preventing context contamination between concurrent sessions.
- Team Coordination: Includes a
$teamcommand to handle parallel execution lanes for complex stories. - Configurable Guidance: Supports project-scoped
AGENTS.mdfiles to provide durable instructions and safety rules for specific repositories.
Related
- Project
- Dispatch
- Dispatch
- Project
- Project