omx-setup
Setup and configure oh-my-codex using current CLI behavior
Best for Project onboardingWorks with GitHubLow risk
⌘source
- author
@Yeachan-Heo- language
- TypeScript
★24kstars
2kforks
Apr 19, 2026
✦overview.md
Key Features
- ·Installs and configures oh-my-codex for current project and user directories
- ·Supports scoped installation (user or project)
- ·Includes dry-run and force overwrite options
- ·Generates project documentation (AGENTS.md)
- ·Configures system hooks and interop markers
Use Cases
- →Setting up oh-my-codex for the first time on a new machine
- →Refreshing or reinstalling oh-my-codex configuration after updates
- →Preparing a development environment in CI/CD pipelines
- →Migrating from legacy oh-my-codex installations to current versions
Best for
- ✓Project onboarding
- ✓CI/CD automation
- ✓Development environment setup
Not ideal for
- !One-time script execution
- !Lightweight documentation scaffolding only
FAQs
name
omx-setup
description
Setup and configure oh-my-codex using current CLI behavior
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] [--dry-run] [--verbose] [--scope <user|project>]
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--dry-run: print actions without mutating files--verbose: print per-file/per-step details--scope: choose install scope (user,project)
What this setup actually does
omx setup performs these steps:
- Resolve setup scope:
--scopeexplicit value- else persisted
./.omx/setup-scope.json(with automatic migration of legacy values) - else interactive prompt on TTY (default
user) - else default
user(safe for CI/tests)
- Create directories and persist effective scope
- Install prompts, native agent configs, skills, and merge config.toml (scope determines target directories)
- Verify Team CLI API interop markers exist in built
dist/cli/team.js
$install
1-click copynpx skills add Yeachan-Heo/oh-my-codex --skill omx-setupSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.