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

> An open-source extension layer for Codex CLI that adds hook systems, agent team orchestration, and real-time heads-up displays.

## Install

Save as a script file and run:

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

## Quick Use
```bash
npx oh-my-codex init
# or install globally
npm install -g oh-my-codex
omx setup
```

## 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


---
Source: https://tokrepo.com/en/workflows/asset-a3959387
Author: Script Depot