$omx-setup
A skill that installs or updates OMX prompts, skills, and configuration.
Overview
$omx-setup gets the OMX environment ready. It initializes a fresh setup or updates an existing one, placing skill files, agent prompts, and hook configuration into their correct install paths. Run it once to install. Run it again after any upgrade to sync your configuration.
From the CLI, omx setup runs the same thing.
Example
$omx-setup
$omx-setup --scope user
$omx-setup --scope project| Option | Description |
|---|---|
| (none) | Install to the default scope |
--scope user | Global install to ~/.codex/ |
--scope project | Project-scoped install to .codex/ |
When to use
- When installing OMX for the first time
- When syncing configuration after upgrading the
oh-my-codexpackage - When replicating an existing environment on a new machine
- When skills or hooks are not working correctly and you need to reinstall
When to avoid
- Diagnosing environment issues — if something seems broken, run
$doctorbefore$omx-setup.
Related
- Getting started — full installation flow
- $doctor — diagnose installation state and configuration issues
- Quick commands —
omx setupCLI reference