aha-codex-omx

Installation
SKILL.md

aha-codex-omx

What This Mode Activates

Full-delegation capability orchestration for Codex CLI with oh-my-codex (OMX) installed. This skill enables the agent to autonomously discover, select, combine, and reselect available capability surfaces (native runtime, enhancement layer, skill, MCP, command, subagent, worktree) to build the lowest-sufficient execution route for each task unit.

Pre-Check

Run detection at three levels. Do not collapse a partial failure into a full fallback — only re-orchestrate the specific surface that is unavailable.

  1. L1 Binary installed: Verify OMX binary is installed: omx --version
  2. L2 CLI surface available: Verify core OMX CLI commands work: omx list, omx exec --help. If L2 passes, the agent may use OMX skill enumeration, exec delegation, and sparkshell throughout the session.
  3. L3 Interactive bridge available: Verify tmux-attached interactive bridge if the task needs omx question or team/question orchestration. Check whether a tmux session is attached. If L3 fails, skip omx question and team bridge features, but continue using L2 CLI surfaces.
  4. Confirm runtime family: Codex (not OpenCode, not oh-my-openagent (OMO))
  5. Wrong-runtime guard: If you are in OpenCode with OMO, use aha-opencode-omo instead. This skill is for Codex+OMX only.
  6. Fallback rule: If L1 fails (OMX binary not installed), proceed with native Codex capabilities and state the limitation transparently. If L1 passes but L2 or L3 fail, do not fall back to native Codex — only skip the specific unavailable OMX surface and continue using available OMX CLI surfaces.

Capability Discovery

Installs
1
First Seen
Jun 26, 2026
aha-codex-omx — its-how/aha-orch