Oh My Codex
oh-my-codex (omx) — Orchestration layer for OpenAI Codex CLI. Async Claude Code delegation (no timeouts), structured workflows (autopilot, TDD, code review, planning), persistent state & memory. Like oh-my-zsh but for Codex.
What is Oh My Codex?
Oh My Codex is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to oh-my-codex (omx) — orchestration layer for openai codex cli. async claude code delegation (no timeouts), structured workflows (autopilot, tdd, code review, planning), persistent state & memory. like ...
oh-my-codex (omx) — Orchestration layer for OpenAI Codex CLI. Async Claude Code delegation (no timeouts), structured workflows (autopilot, TDD, code review, planning), persistent state & memory. Like oh-my-zsh but for Codex.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- oh-my-codex (omx) — Orchestration layer for OpenAI Codex CLI
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx oh-my-codexConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Oh My Codex
Oh My Codex (OMX) is an orchestration layer and plugin ecosystem built on top of the OpenAI Codex CLI that adds async task delegation, persistent state and memory, structured multi-agent workflows, and a catalog of pre-built skills like TDD, deep research, code review, and planning. It solves the timeout problem in Claude Code delegation by making task execution asynchronous, and provides a HUD, session management, and team-based agent coordination through a set of MCP tool families. Developers use it to run long-running AI coding tasks without blocking, manage agent teams, and apply repeatable structured workflows to their projects.
Prerequisites
- Node.js and npm installed
- OpenAI Codex CLI installed and configured
- Claude Code or another MCP-compatible client
- Git to clone the repository
- npm link capability (global npm write access)
Clone the oh-my-codex repository
Download the OMX source into your workspace. The repository contains the CLI, MCP server packages, and all skill definitions.
git clone https://github.com/scalarian/oh-my-codex
cd oh-my-codexInstall dependencies and build
Install all workspace packages and compile the TypeScript source.
npm install
npm run buildLink the CLI globally
Make the 'omx' command available system-wide by linking the CLI package.
cd packages/cli && npm linkRun setup and diagnostics
Run 'omx setup' to initialize state directories and configure hooks, then 'omx doctor' to verify the environment is configured correctly.
omx setup
omx doctorInstall workflow hooks
Add the built-in hooks for workspace context loading, memory, safety guardrails, and code review to your Codex configuration.
omx hooks install --presets=workspace-context,memory,safety,reviewLaunch a workflow with a skill
Use a built-in skill like $ultrawork to delegate a full-stack task asynchronously. The task runs in the background without blocking your session.
omx team queue "implement the payment webhook handler"Oh My Codex Examples
Client configuration
Configure Claude Code to use OMX as an MCP server for async task delegation and workflow management.
{
"mcpServers": {
"oh-my-codex": {
"command": "npx",
"args": ["oh-my-codex"]
}
}
}Prompts to try
Use OMX skills to delegate complex coding tasks, run structured workflows, and manage agent teams.
- "Use $ultrawork to ship the authentication feature end to end"
- "Start a TDD workflow for the new billing module using $tdd"
- "Queue a code review task for the current PR diff"
- "Show me the status of all running agent tasks and which executor is assigned"Troubleshooting Oh My Codex
The 'omx' command is not found after npm link
Verify npm's global bin directory is in your PATH by running 'npm bin -g'. If not, add it to your shell profile (e.g., export PATH="$(npm bin -g):$PATH"). Then re-run 'npm link' from the packages/cli directory.
omx doctor reports missing dependencies or configuration errors
Run 'omx setup repair' to re-initialize missing state directories and re-register cron jobs. Then re-run 'omx doctor' to confirm all checks pass before starting tasks.
Async tasks submitted with omx team queue do not appear to run
Check that 'omx team init' has been run to initialize the team coordinator. Verify that the executor agent is spawned with 'omx team spawn'. Inspect logs in the .omx/logs/ directory for error messages.
Frequently Asked Questions about Oh My Codex
What is Oh My Codex?
Oh My Codex is a Model Context Protocol (MCP) server that oh-my-codex (omx) — orchestration layer for openai codex cli. async claude code delegation (no timeouts), structured workflows (autopilot, tdd, code review, planning), persistent state & memory. like oh-my-zsh but for codex. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Oh My Codex?
Follow the installation instructions on the Oh My Codex GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Oh My Codex?
Oh My Codex works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Oh My Codex free to use?
Yes, Oh My Codex is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Oh My Codex Alternatives — Similar Coding Agents Servers
Looking for alternatives to Oh My Codex? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Oh My Codex in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Oh My Codex?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.