Repolode
Submit
Yeachan-Heo

Yeachan-Heo/oh-my-codex

A workflow and runtime layer for OpenAI Codex CLI that adds structured planning, durable goal execution, parallel agent teams, and state tracking under .omx/.

View on GitHubWebsite
Stars
33,574
Forks
2,549
Open issues
1
Last commit
9 hours ago

What is it?

oh-my-codex (OMX) is a workflow layer that sits on top of OpenAI Codex CLI. Codex remains the execution engine; OMX adds a standard flow that moves from requirement clarification (`$deep-interview`) to planning (`$ralplan`) to durable multi-goal execution (`$ultragoal`), with `$team` available for coordinated parallel work inside a story.

OMX provides reusable specialist roles and skills, project guidance through scoped AGENTS.md files, and a launch wrapper that can run sessions in separate git worktrees. Plans, logs, memory and mode state are kept under a `.omx/` directory in the project. It also includes a mission runner for sequential prompt batches, session export and token-usage commands, and a tmux-based HUD for monitoring.

The project targets macOS and Linux with Codex CLI as the recommended setup; native Windows support is described as secondary. It is installed via npm and requires Node.js 20 or later.

Key features

  • 01Standard workflow from clarification through planning to durable execution
  • 02Durable multi-goal runs with checkpoint ledgers under .omx/ultragoal
  • 03Parallel agent teams via tmux and dedicated git worktrees
  • 04Launch wrapper with named worktree isolation for concurrent sessions
  • 05Mission runner for sequential prompt batches with status and resume
  • 06Session export, timeline and token-usage inspection commands

Use cases

  • Turning a vague feature request into an approved plan before Codex edits code
  • Running long, multi-step refactors with checkpointed progress across sessions
  • Splitting a large task into parallel worker lanes in separate worktrees
  • Batching a checklist of Codex prompts to run unattended one after another

Quick start

  1. 1

    Install Codex CLI via npm (skip if already installed with Homebrew)

    npm install -g @openai/codex
  2. 2

    Install oh-my-codex globally

    npm install -g oh-my-codex
  3. 3

    Run the doctor check to verify the install

    omx doctor
  4. 4

    Launch OMX from inside a git project

    omx

Things to know

  • Primarily designed for macOS or Linux; native Windows is less supported and may behave inconsistently.
  • Requires Node.js 20+ and an authenticated Codex CLI.
  • The recommended durable team runtime needs tmux on macOS or Linux.
  • The --madmax flag disables Codex approval and sandbox guardrails, so use it only in trusted environments.

Topics

#codex#ai-agents#workflow#llm#cli#tmux#git-worktree#typescript

FAQ

What is oh-my-codex?
A workflow and runtime layer for OpenAI Codex CLI that adds structured planning, durable goal execution, parallel agent teams, and state tracking under .omx/. oh-my-codex (OMX) is a workflow layer that sits on top of OpenAI Codex CLI. Codex remains the execution engine; OMX adds a standard flow that moves from requirement clarification (`$deep-interview`) to planning (`$ralplan`) to durable multi-goal execution (`$ultragoal`), with `$team` available for coordinated parallel work inside a story.
Is oh-my-codex free to use? What license does it have?
oh-my-codex is open source under the MIT license. Check the license terms before using it in commercial products.
Is oh-my-codex still maintained?
Actively maintained. The last commit to oh-my-codex was on Oct 20, 2026.
What can I use oh-my-codex for?
Turning a vague feature request into an approved plan before Codex edits code Running long, multi-step refactors with checkpointed progress across sessions Splitting a large task into parallel worker lanes in separate worktrees Batching a checklist of Codex prompts to run unattended one after another
How do I install oh-my-codex?
Install Codex CLI via npm (skip if already installed with Homebrew): npm install -g @openai/codex Install oh-my-codex globally: npm install -g oh-my-codex Run the doctor check to verify the install: omx doctor Launch OMX from inside a git project: omx
Where can I get oh-my-codex?
The source code and installation instructions are on GitHub: https://github.com/Yeachan-Heo/oh-my-codex

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects