- CollectionAgent Harnesses & Operator Surfaces
- Classificationagent-native
- LicenseMIT (root LICENSE file, confirmed 2026-09-26)
- MCPOptional
- Agent SkillAvailable
- InterfacesAgent Skill · MCP · CLI
- Verified2026-09-26
What it does
OMX keeps Codex as the execution engine and adds a repeatable control layer for planning, durable goals, specialist roles, multi-agent teams, worktree isolation, lifecycle hooks, runtime state, replay, and operator visibility. Its canonical flow moves from clarification and plan review into checkpointed execution, with .omx/ preserving plans, logs, memory, mission state, worker assignments, and recovery data across turns.
Agent-facing interfaces
- Interaction pattern: Codex wrapper CLI + project setup + Agent Skills
- Catalog protocols: Agent Skill, MCP, CLI
- MCP: ⚠️ Optional compatibility surface
- Agent Skill: ✅ Bundled
- Onboarding type:
agent-skill
How agents onboard
Interaction pattern: Codex wrapper CLI + project setup + Agent Skills
# Requires an already-working, authenticated Codex CLI and Node.js 20+
codex --version
npm install -g oh-my-codex
# Run from the actual project root
omx setup --scope project --merge-agents
omx doctor
omx exec --skip-git-repo-check -C . "Reply with exactly OMX-EXEC-OK"
# Safer isolation for an autonomous session
omx --worktree=feat/task --xhigh
See the full onboarding section in the dossier.
Protocol surface
| Interface | Detail |
|---|---|
| CLI | omx setup, launch, exec, doctor, state, team, session, and workflow commands |
| Hooks | Official Codex plugin-scoped hooks plus documented runtime fallbacks |
| Skills | Bundled Codex skills and specialist workflows |
| State/events | Structured JSON/JSONL command, event, snapshot, mission, and checkpoint artifacts |
| Runtime | Codex CLI, tmux/psmux where supported, and Git worktrees |
Verification
Last verified 2026-09-26.
Sources:
- https://github.com/Yeachan-Heo/oh-my-codex/releases/tag/v0.21.6
- https://oh-my-codex.dev
- https://api.github.com/repos/Yeachan-Heo/oh-my-codex