Quick Commands
Cheat sheet of the most-used OMX CLI commands for setup, diagnostics, session management, and team operations.
A reference card for the commands you reach for most often. All commands assume omx is on your PATH. If it is not, use npx oh-my-codex or the full path to the installed binary.
| Command | Description |
|---|
omx setup | Install or refresh OMX prompts, skills, and config. Run after upgrading or on a new machine. |
omx setup --scope user | Install to user-level config (~/.codex/). |
omx setup --scope project | Install to project-level config (.codex/). |
omx doctor | Check OMX installation health — missing files, config issues, hook pipeline status. |
omx doctor --team | Additional team-pipeline health checks. |
| Command | Description |
|---|
omx | Start an interactive OMX/Codex session. |
omx --madmax | Start with maximum-parallelism team pipeline. |
omx --madmax --high | Start with max parallelism and the highest-tier model. |
omx --skip-git-repo-check | Start outside a git repository without errors. |
omx cancel | Cancel the current active OMX execution mode (ralph, autopilot, ultrawork). |
| Command | Description |
|---|
omx help | Print full CLI help and available flags. |
omx --version | Print the installed OMX version. |
| Command | Description |
|---|
omx team api list-tasks --json | List current team tasks in machine-readable JSON. |
omx team api read-task --json | Read the current active task. |
omx team api get-summary --json | Get a summary of team state. |
omx team await | Block until a wakeable team event occurs. |
| Command | Description |
|---|
omx agents-init [path] | Bootstrap an AGENTS.md for the project at path (defaults to current directory). |
