omx-setup

Installation
SKILL.md

OMX Setup

Use this skill when users want to install or refresh oh-my-codex for the current project plus user-level OMX directories.

Command

omx setup [--force] [--merge-agents] [--dry-run] [--verbose] [--scope <user|project>] [--plugin|--legacy|--install-mode <legacy|plugin>]

If you only want lightweight AGENTS.md scaffolding for an existing repo or subtree, use omx agents-init [path] instead of full setup.

Supported setup flags (current implementation):

  • --force: overwrite/reinstall managed artifacts where applicable
  • --merge-agents: when AGENTS.md already exists, preserve user-authored content and insert/refresh OMX-managed generated sections between explicit <!-- OMX:AGENTS:START --> / <!-- OMX:AGENTS:END --> markers
  • --dry-run: print actions without mutating files
  • --verbose: print per-file/per-step details
  • --scope: choose install scope (user, project)
  • --plugin: use Codex plugin delivery for bundled skills while archiving/removing legacy OMX-managed prompts/native agents and keeping setup-owned runtime hooks
Related skills
Installs
67
GitHub Stars
28.3K
First Seen
Feb 17, 2026