oh-my-codex_skill

Overview

This skill is a multi-agent orchestration layer for the OpenAI Codex CLI that coordinates specialized agents, staged pipelines, and team workers for complex software tasks. It provides 30 role-based agents, 40+ workflow skills, persistent MCP servers for state and code intelligence, and tmux-based team orchestration to run parallel workers. Use it to automate plan→execute→verify cycles and maintain long-running, stateful development sessions.

How this skill works

oh-my-codex launches a Codex CLI session enriched with role prompts and workflow skills. It manages persistent MCP servers (state, memory, code-intel, trace) to store context and trace execution across turns. Workflows run as staged pipelines or parallel teams in tmux, and hook plugins let you attach lifecycle events for custom automation.

When to use it

• Orchestrating multi-step development pipelines (plan → prd → exec → verify → fix).
• Running coordinated, parallel team workers to tackle large refactors or builds.
• Maintaining long-lived project context, memory, and code intelligence across sessions.
• Automating code review, security audits, and test-first development at scale.
• Integrating custom hooks and plugins into agent lifecycles for CI-style workflows.

Best practices

• Define clear role prompts and an AGENTS.md to guide agent behavior for your project.
• Use team mode for parallelizable tasks and monitor progress with omx team status and omx team resume.
• Favor staged pipeline execution (plan → exec → verify → fix) to separate design, implementation, and validation.
• Start with conservative flags (--high) before using aggressive modes like --xhigh or --madmax. Use --dry-run to preview changes.
• Persist MCP servers for long-running sessions to keep memory, traces, and code context available.

Example use cases

• Autopilot an entire feature from idea to working code using $autopilot with staged verification.
• Run a 4-person executor team in tmux to parallelize a multi-module refactor: omx team 4:executor "task".
• Perform a comprehensive security audit using $security-review and the security-reviewer agent.
• Execute TDD workflows with $tdd to generate tests, implement code, and refactor in red-green-refactor cycles.
• Fix build errors and type failures automatically with $build-fix and build-fixer agents across CI runs.