--- id: sm-oh-my-codex name: "oh-my-codex" url: https://skills.yangsir.net/skill/sm-oh-my-codex author: supercent-io domain: ai-agent-orchestration-collaboration tags: ["code-generation", "ai-pair-programming", "llm-development", "software-engineering", "ai-tools"] install_count: 10000 rating: 4.50 (400 reviews) github: https://github.com/supercent-io/skills-template --- # oh-my-codex > 此技能是OpenAI Codex CLI的多代理编排器，用于协调复杂的AI多代理工作流，并支持并行团队协作。 **Stats**: 10,000 installs · 4.5/5 (400 reviews) ## Before / After 对比 ### OpenAI Codex多代理编排，复杂工作流并行 ## Readme # oh-my-codex # oh-my-codex (OMX) - Multi-Agent Orchestration for Codex CLI ## When to use this skill - Orchestrating complex multi-agent workflows with OpenAI Codex CLI - Running parallel team workers in tmux for coordinated task execution - Using persistent MCP servers for state, memory, and code intelligence - Executing staged pipelines (plan → prd → exec → verify → fix) - Leveraging role-based agent prompts for specialized tasks ## 1. Core Concepts ### Role Prompts (30 Agents) Agent Tier Agents Use Case **Core Development** architect, planner, executor, debugger, verifier, explore Main development workflow **Quality Assurance** style-reviewer, quality-reviewer, api-reviewer, security-reviewer, performance-reviewer Code review lane **Domain Experts** dependency-expert, test-engineer, build-fixer, designer, writer, qa-tester Specialized tasks **Product Strategy** product-manager, ux-researcher, product-analyst, information-architect Product planning ### Workflow Skills (40+) Skill Trigger Description `autopilot` `$autopilot` Full autonomous execution from idea to working code `ralph` `$ralph` Self-referential loop with verifier verification until completion `ultrawork` `$ulw` Maximum parallelism with parallel agent orchestration `team` `$team` N coordinated agents using Codex CLI native teams `plan` `$plan` Strategic planning with consensus and review modes `research` `$research` Parallel scientist agents for comprehensive research `tdd` `$tdd` Test-first development with red-green-refactor cycle `build-fix` `$build-fix` Fix build errors, type errors, and toolchain failures `code-review` `$code-review` Comprehensive code review across all quality dimensions `security-review` `$security-review` Security audit focusing on vulnerabilities and trust boundaries `cancel` `$cancel` Stop execution modes and clear active state ### MCP Servers Server Purpose `omx_state` Persistent mode lifecycle state `omx_memory` Memory + notepad surfaces for long-running sessions `omx_code_intel` Code intelligence and context `omx_trace` Execution tracing and debugging ## 2. Installation & Setup ### Prerequisites - macOS or Linux (Windows via WSL2) - Node.js >= 20 - Codex CLI installed (`npm install -g @openai/codex`) - Codex auth configured ### Install oh-my-codex ``` npm install -g oh-my-codex omx setup omx doctor ``` ### Recommended Launch Profile ``` # Trusted environment with high reasoning omx --xhigh --madmax ``` ## 3. Usage Patterns ### Role Prompts (Inside Codex) ``` /prompts:architect "analyze current auth boundaries" /prompts:executor "implement input validation in login" /prompts:security-reviewer "audit OAuth flow" ``` ### Workflow Skills ``` $plan "ship OAuth callback safely" $autopilot "implement user registration" $team 3:executor "fix all TypeScript errors" ``` ### Team Mode (Terminal) ``` # Start parallel team workers omx team 4:executor "parallelize a multi-module refactor" # Monitor team status omx team status # Resume team work omx team resume # Shutdown team omx team shutdown ``` ## 4. Launch Flags Flag Description `--yolo` Fast execution, minimal verification `--high` High reasoning effort `--xhigh` Extra-high reasoning effort `--madmax` Maps to Codex `--dangerously-bypass-approvals-and-sandbox` `--force` Force operation `--dry-run` Preview without execution `--verbose` Verbose output ## 5. Staged Pipeline OMX implements a structured execution pipeline: ``` team-plan → team-prd → team-exec → team-verify → team-fix ``` - **Plan**: Strategic decomposition of work - **PRD**: Product requirements definition - **Exec**: Parallel execution by team workers - **Verify**: Validation of deliverables - **Fix**: Automated error resolution ## 6. Hook Extensions (v0.4.0+) ### Native Lifecycle Events - `session-start` / `session-end` / `session-idle` - `turn-complete` ### Plugin Workflow ``` # Enable hook plugins OMX_HOOK_PLUGINS=1 omx hooks test # Hook commands omx hooks init # Initialize hooks omx hooks status # Check hook status omx hooks validate # Validate configuration omx hooks test # Test hook execution ``` Plugin files: `.omx/hooks/*.mjs` ## 7. Configuration ### AGENTS.md Injection By default, OMX injects project-level AGENTS.md: ``` -c model_instructions_file="/AGENTS.md" ``` ### Environment Controls ``` # Disable AGENTS.md injection OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx # Custom instructions file OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx ``` ## Quick Reference Command Action `omx` Launch Codex with HUD `omx setup` Install prompts, skills, config wiring `omx doctor` Installation/runtime diagnostics `omx doctor --team` Team/swarm diagnostics `omx team : ""` Start team workers `omx team status ` Show team status `omx team shutdown ` Shutdown team `omx status` Show active modes `omx cancel` Cancel execution modes `omx reasoning ` Set reasoning (low/medium/high/xhigh) `omx hud` HUD display options `omx help` Show help ## Resources - **Website**: [https://yeachan-heo.github.io/oh-my-codex-website/](https://yeachan-heo.github.io/oh-my-codex-website/) - **GitHub**: [https://github.com/Yeachan-Heo/oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex) - **npm**: [https://www.npmjs.com/package/oh-my-codex](https://www.npmjs.com/package/oh-my-codex) ## License MIT License Weekly Installs10.0KRepository[supercent-io/sk…template](https://github.com/supercent-io/skills-template)GitHub Stars58First SeenFeb 17, 2026Security Audits[Gen Agent Trust HubFail](/supercent-io/skills-template/oh-my-codex/security/agent-trust-hub)[SocketPass](/supercent-io/skills-template/oh-my-codex/security/socket)[SnykWarn](/supercent-io/skills-template/oh-my-codex/security/snyk)Installed oncodex10.0Kgemini-cli10.0Kopencode9.9Kgithub-copilot9.9Kcursor9.9Kkimi-cli9.9K --- *Source: https://skills.yangsir.net/skill/sm-oh-my-codex* *Markdown mirror: https://skills.yangsir.net/api/skill/sm-oh-my-codex/markdown*