Oh-My-Codex — Hooks, Agent Teams, and HUDs for Codex CLI

Introduction

Oh-My-Codex (OmX) extends the Codex CLI with hooks, multi-agent team support, and real-time heads-up displays. It adds orchestration and observability layers on top of the standard Codex experience without replacing it.

What Oh-My-Codex Does

• Adds pre- and post-execution hooks to Codex CLI sessions
• Enables multi-agent team workflows where multiple agents collaborate
• Provides a terminal HUD for monitoring agent progress in real time
• Supports custom automation scripts triggered by agent events
• Integrates with existing Codex configurations and workspaces

Architecture Overview

OmX wraps the Codex CLI process, intercepting its event stream to trigger hooks and render the HUD. Agent teams are defined in a configuration file that maps roles to specific prompts and constraints. The HUD uses a terminal UI framework to display live status, token usage, and task progress alongside the main agent output.

Self-Hosting & Configuration

• Install via npm and run the setup wizard
• Configure hooks in a YAML or JSON config file
• Define agent team roles with specific prompts and capabilities
• Customize HUD layout and information panels
• Set environment variables for model and provider preferences

Key Features

• Drop-in enhancement for existing Codex CLI workflows
• Event-driven hook system for pre/post agent actions
• Multi-agent team coordination with role definitions
• Real-time terminal HUD with token and progress tracking
• Plugin system for community-contributed extensions

Comparison with Similar Tools

• Codex CLI — the base agent; OmX adds orchestration on top
• Oh-My-OpenAgent — similar concept for OpenCode; OmX is Codex-specific
• Claude Code — Anthropic native agent; OmX targets the Codex ecosystem
• KiloCode — full platform; OmX is a lightweight wrapper

FAQ

Q: Does OmX work without Codex CLI installed? A: No. It requires Codex CLI as the underlying agent runtime.

Q: Can I use custom hooks for CI/CD integration? A: Yes. Hooks can run any shell command, making CI/CD integration straightforward.

Q: Does it support models other than OpenAI? A: OmX passes through to whatever models Codex CLI supports, including compatible providers.

Q: Is there a performance overhead? A: Minimal. OmX adds a thin process wrapper and event listener with negligible latency impact.

Sources

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