Neura Market
**oh-my-codex** logo

**oh-my-codex**

Free

Yeachan Heo

FreeFree tier
Inputs: text, codeOutputs: code, text
Type
Open Source
Visit Website GitHub (40 stars)

About **oh-my-codex**

OMX (Oh My Codex) is an open-source workflow layer for OpenAI Codex CLI, designed to enhance and extend Codex sessions with better prompts, workflows, and runtime assistance. It keeps Codex as the execution engine and adds capabilities such as hooks, agent teams, HUDs (heads-up displays), and a consistent workflow pipeline. OMX provides default workflows like $deep-interview, $ralplan, and $ultragoal to guide projects from clarification to completion. It stores project guidance, plans, logs, and state in a .omx/ directory. The project is maintained by Yeachan Heo and a community of contributors, available via npm as 'oh-my-codex'. Primarily tuned for macOS and Linux with Codex CLI, it currently offers limited support for native Windows and the Codex App.

Key Features

Enhances Codex CLI with better prompts, workflows, and runtime help
Provides default workflows: $deep-interview, $ralplan, $ultragoal
Adds hooks, agent teams, and HUDs (heads-up displays)
Plugin and skill system (plugins/, skills/, prompts/)
State management in .omx/ directory for project guidance and logs
Easy installation via npm: npm install -g oh-my-codex
Open source with active community on GitHub and Discord

Pros & Cons

Pros
  • Free and open source with no licensing costs
  • Significantly enhances Codex CLI capabilities with minimal setup
  • Provides structured, repeatable workflows for development tasks
  • Active community with contributors and Discord support
  • Plugin system allows for custom extensions and skills
  • Stores project state locally for continuity across sessions
Cons
  • Primarily designed for macOS and Linux; Windows support is limited and may break
  • Requires OpenAI Codex CLI to be installed first (not a standalone tool)
  • Still in active development with no stable release version explicitly stated
  • Learning curve for users unfamiliar with CLI or Codex workflows
  • Default experience may not suit all types of projects or development styles

Best For

Starting a stronger, more structured Codex CLI sessionAutomating software development workflows from planning to completionManaging complex projects with consistent AI-driven pipelinesExtending Codex CLI with custom prompts, plugins, and agent teams

FAQ

What is OMX (Oh My Codex)?
OMX is a workflow layer for OpenAI Codex CLI that adds prompts, workflows, hooks, agent teams, HUDs, and runtime help to enhance Codex sessions.
How do I install OMX?
Install via npm with the command: npm install -g oh-my-codex. You can install it alongside Codex CLI or after installing Codex CLI via Homebrew, npm, or another method.
What are the system requirements?
OMX is primarily designed and actively tuned for macOS or Linux with Codex CLI. Native Windows and Codex App are not the default experience and may behave inconsistently.
Does OMX work on Windows?
Support for native Windows is limited. The recommended default is macOS or Linux. Windows users may encounter issues and receive less support.
Is OMX free?
Yes, OMX is open source and free to use. You only need a Codex CLI (which may have its own costs) and optionally a GitHub account.
How do I start a workflow with OMX?
After installation, run 'omx --worktree=feat/task --madmax --xhigh' from your project directory. This invokes the canonical default workflow with commands like $deep-interview, $ralplan, and $ultragoal.