# oh-my-codex | Bellman | Knowledge Base | Instagit

OmX - Oh My codeX: Your codex is not alone. Add hooks, agent teams, HUDs, and so much more.

GitHub Stars: 12.7k

Repository: https://github.com/Yeachan-Heo/oh-my-codex

---

## Articles

### [How PRD Mode Works in Ralph with the --prd Flag and User Stories in oh-my-codex](/Yeachan-Heo/oh-my-codex/how-does-prd-mode-work-in-ralph-with-prd-flag-and-user-stories-in-oh-my-codex)

Discover how Ralph's PRD mode and --prd flag work in oh-my-codex. Learn to generate artifacts and break requirements into user stories for efficient development.

- Tags: how-to-guide
- Published: 2026-04-03

### [Anti-Slop Workflow in oh-my-codex: A Complete Guide to Cleanup and Refactor Tasks](/Yeachan-Heo/oh-my-codex/what-is-anti-slop-workflow-for-cleanup-refactor-deslop-tasks-in-oh-my-codex)

Master the anti-slop workflow in oh-my-codex. This guide details a 6-step process for cleanup, refactoring, and deslopping code with regression tests and quality gates for cleaner projects.

- Tags: how-to-guide
- Published: 2026-04-03

### [How to Configure tmux and psmux for Team Mode in oh-my-codex](/Yeachan-Heo/oh-my-codex/how-to-configure-tmux-psmux-for-team-mode-on-different-platforms-in-oh-my-codex)

Configure tmux or psmux for oh-my-codex team mode on macOS, Linux, Windows, or WSL2. Install the correct binary, add to PATH, and start collaborating with ease.

- Tags: how-to-guide
- Published: 2026-04-03

### [Verification Loop Protocol in Oh-My-Codex: Fresh Evidence Requirements Explained](/Yeachan-Heo/oh-my-codex/what-is-verification-loop-protocol-requiring-fresh-evidence-before-completion-in-oh-my-codex)

Understand the oh-my-codex verification loop protocol. Learn how fresh evidence like test output and build success is required before task completion, enforced by the Ralph persistence loop.

- Tags: deep-dive
- Published: 2026-04-03

### [How the Cancellation Skill Works Across Execution Modes in oh-my-codex](/Yeachan-Heo/oh-my-codex/how-does-cancellation-skill-work-across-different-execution-modes-in-oh-my-codex)

Learn how oh-my-codex cancellation skill terminates active workflows by detecting session states and updating mode. Prevent stale processes and orphaned workers.

- Tags: internals
- Published: 2026-04-03

### [Understanding the OMX Runtime Overlay Contract in oh-my-codex](/Yeachan-Heo/oh-my-codex/what-is-runtime-overlay-contract-with-oh-my-codex-omx-runtime-start-end-markers)

Understand the OMX runtime overlay contract in oh-my-codex. Learn how OMX:RUNTIME:START/END markers inject temporary data into immutable files without changing static policy text.

- Tags: internals
- Published: 2026-04-03

### [How to Debug oh-my-codex Startup CPU Spikes on Intel Macs (syspolicyd/trustd)](/Yeachan-Heo/oh-my-codex/how-to-debug-oh-my-codex-startup-cpu-spikes-on-intel-macs-syspolicyd-trustd)

Debug oh-my-codex startup CPU spikes on Intel Macscaused by syspolicyd and trustd. Learn how to resolve Gatekeeper verification issues and optimize performance.

- Tags: how-to-guide
- Published: 2026-04-03

### [Oh-My-Codex Team Model Resolution Precedence: Explicit vs Inherited vs Default](/Yeachan-Heo/oh-my-codex/what-is-team-model-resolution-precedence-explicit-args-inherited-default-in-oh-my-codex)

Understand Oh-My-Codex team model resolution precedence. Explicit arguments override inherited settings and defaults for robust control.

- Tags: deep-dive
- Published: 2026-04-03

### [How Model Routing Matches Roles to Task Complexity in oh-my-codex](/Yeachan-Heo/oh-my-codex/how-does-model-routing-match-roles-to-task-complexity-explore-vs-executor-vs-architect-in-oh-my-codex)

Discover how oh-my-codex model routing matches roles explore executor architect to task complexity. Learn to optimize LLM model selection for your coding needs.

- Tags: architecture
- Published: 2026-04-03

### [Guidance Schema Contract in oh-my-codex AGENTS.md: Required Sections Explained](/Yeachan-Heo/oh-my-codex/what-is-guidance-schema-contract-and-required-sections-in-oh-my-codex-agents-md)

Understand the guidance schema contract in oh-my-codex AGENTS.md, detailing its six required sections to standardize agent behavior. Learn how it ensures robust and predictable agent execution.

- Tags: api-reference
- Published: 2026-04-03

### [How to Integrate oh-my-codex with OpenClaw Notification Gateway: Complete Setup Guide](/Yeachan-Heo/oh-my-codex/how-to-integrate-oh-my-codex-with-openclaw-notification-gateway)

Integrate oh-my-codex with OpenClaw notification gateway easily. Learn how to set up tokenized environment variables for lifecycle event mapping and streamline your workflow.

- Tags: how-to-guide
- Published: 2026-04-03

### [oh-my-codex explore vs omx sparkshell command routing: Key Differences](/Yeachan-Heo/oh-my-codex/what-is-difference-between-oh-my-codex-explore-and-omx-sparkshell-command-routing)

Discover key differences between oh-my-codex explore and omx sparkshell. Understand explore for read-only queries and sparkshell for shell-native command routing in oh-my-codex.

- Tags: deep-dive
- Published: 2026-04-03

### [The Deslop Pass (ai-slop-cleaner) Workflow After Ralph Completion in oh-my-codex](/Yeachan-Heo/oh-my-codex/what-is-deslop-pass-ai-slop-cleaner-workflow-after-ralph-completion-in-oh-my-codex)

Understand the deslop pass ai-slop-cleaner workflow in oh-my-codex. Learn how it automates file cleanup after Ralph's architect-verification and regression testing.

- Tags: workflow-explanation
- Published: 2026-04-03

### [How the oh-my-codex Planning Gate Enforces PRD and Test-Spec Before Ralph Execution](/Yeachan-Heo/oh-my-codex/how-does-planning-gate-enforce-prd-test-spec-existence-before-ralph-execution-in-oh-my-codex)

Learn how the oh-my-codex planning gate ensures PRD and test-spec files exist before ralph execution, redirecting incomplete requests to ralplan automatically.

- Tags: how-to-guide
- Published: 2026-04-03

### [Child Agent Protocol in oh-my-codex: Understanding the 6 Concurrent Agent Limit](/Yeachan-Heo/oh-my-codex/what-is-child-agent-protocol-in-oh-my-codex-with-max-6-concurrent-agents-limitation)

Understand the oh-my-codex child agent protocol and its 6 concurrent agent limit. Learn how it prevents resource exhaustion and enables safe task delegation for efficient orchestration.

- Tags: internals
- Published: 2026-04-03

### [How to Write a Custom Skill for oh-my-codex with the SKILL.md Format](/Yeachan-Heo/oh-my-codex/how-to-write-custom-skill-for-oh-my-codex-with-skill-md-format)

Learn to write a custom skill for oh-my-codex using the SKILL.md format. Discover how to structure your skill files with YAML front-matter and XML-style markdown sections for seamless integration.

- Tags: how-to-guide
- Published: 2026-04-03

### [oh-my-codex Environment Variables: How OMX_DEFAULT_FRONTIER_MODEL and OMX_SPARK_MODEL Control Model Selection](/Yeachan-Heo/oh-my-codex/what-environment-variables-control-oh-my-codex-behavior-omx-default-frontier-model-omx-spark-model)

Control oh-my-codex model selection with environment variables like OMX_DEFAULT_FRONTIER_MODEL and OMX_SPARK_MODEL. Customize LLM usage without code changes.

- Tags: how-to-guide
- Published: 2026-04-03

### [How the Visual Iteration Gate Uses $visual-verdict Scoring Thresholds in oh-my-codex](/Yeachan-Heo/oh-my-codex/how-does-visual-iteration-gate-work-with-visual-verdict-scoring-thresholds-in-oh-my-codex)

Learn how the visual iteration gate in oh-my-codex uses $visual-verdict scoring thresholds to enforce quality checkpoints and block edits until visual fidelity is met.

- Tags: internals
- Published: 2026-04-03

### [Lore Commit Protocol in oh-my-codex: How to Implement Structured Decision Records](/Yeachan-Heo/oh-my-codex/what-is-lore-commit-protocol-in-oh-my-codex-and-how-to-implement-structured-decision-records)

Learn the Lore commit protocol in oh-my-codex to create machine-readable decision records. Implement structured git trailers like Constraint and Confidence easily.

- Tags: how-to-guide
- Published: 2026-04-03

### [How to Configure Custom Agent Tiers and Model Routing in oh-my-codex AGENTS.md](/Yeachan-Heo/oh-my-codex/how-to-configure-custom-agent-tiers-and-model-routing-in-oh-my-codex-agents-md)

Learn to configure custom agent tiers and model routing in oh-my-codex. Define cost and reasoning levels and map models using AGENTS.md for efficient AI agent management.

- Tags: how-to-guide
- Published: 2026-04-03

### [Team Pipeline Flow in oh-my-codex: 5-Phase Multi-Agent Orchestration](/Yeachan-Heo/oh-my-codex/what-is-team-pipeline-flow-in-oh-my-codex-team-plan-team-prd-team-exec-team-verify-team-fix)

Explore the 5-phase team pipeline flow in oh-my-codex: team-plan, team-prd, team-exec, team-verify, and team-fix. Understand multi-agent orchestration via declarative state management.

- Tags: internals
- Published: 2026-04-03

### [How the Keyword Detection System Auto-Activates Skills in oh-my-codex AGENTS.md](/Yeachan-Heo/oh-my-codex/how-does-keyword-detection-system-auto-activate-skills-in-oh-my-codex-agents-md)

Discover how the keyword detection system in oh-my-codex AGENTS.md automatically activates skills. Learn about message scanning, skill command resolution, and instant workflow execution.

- Tags: how-to-guide
- Published: 2026-04-03

### [Oh-My-Codex State Management: Architecture of the .omx Directory](/Yeachan-Heo/oh-my-codex/what-is-the-architecture-of-oh-my-codex-state-management-under-omx-directory)

Explore the oh-my-codex state management architecture within the .omx directory. Learn how it hierarchically organizes global data, session snapshots, and team artifacts.

- Tags: architecture
- Published: 2026-04-03

### [How Oh-My-Codex Executes Parallel Agent Delegation in Ralph Mode Using Agent Tiers](/Yeachan-Heo/oh-my-codex/how-does-oh-my-codex-execute-parallel-agent-delegation-in-ralph-mode-with-agent-tiers)

Discover how Oh-My-Codex achieves parallel agent delegation in Ralph mode. Learn about staffing plans, agent tiers (LOW, STANDARD, THOROUGH), and simultaneous subagent spawning for efficient task completion.

- Tags: internals
- Published: 2026-04-03