Omc Setup
Install, refresh, or repair oh-my-claudecode via the canonical OMC setup wizard for plugin, npm, or local-dev paths.
Overview
OMC Setup is an agent skill for the Build phase that installs or refreshes oh-my-claudecode using the canonical phased setup wizard.
Install
npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill omc-setupWhat is this skill?
- Canonical setup flow for marketplace/plugin, global npm, and local-dev worktree targets
- Flag-aware behavior: --help, --local, --global, --force with Pre-Setup Check on default invocations
- Respects CLAUDE_CONFIG_DIR for all ~/.claude paths in the guide
- Explicit rule: on invoke, execute the workflow—do not only summarize instructions to the user
- Post-install path clarity for users landing after /plugin install or npm i -g oh-my-claude-sisyphus@latest
- Documented setup phases: Pre-Setup Check plus Phase 1–4 full setup path
Adoption & trust: 531 installs on skills.sh; 36k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You installed oh-my-claudecode from the plugin or npm but hooks, config paths, or local vs global targets are inconsistent or stale.
Who is it for?
Claude Code users right after marketplace or npm install, or when updating a worktree copy and needing a reliable refresh.
Skip if: Builders who do not use Claude Code/OMC, or who only want application deployment—not agent framework setup.
When should I use this skill?
Install, refresh, or repair oh-my-claudecode for plugin, npm, or local-dev setups; use --help for usage only.
What do I get? / Deliverables
OMC completes the official setup phases so Claude Code loads the expected OMC configuration from the right target without manual dotfile surgery.
- Configured OMC targets (local and/or global)
- Completed phased setup state after plugin or npm install
- Help text output when invoked with --help
Recommended Skills
Journey fit
Agent tooling is the primary shelf because the skill configures Claude Code’s OMC extension—not application feature code. omc-setup is the single entry command after marketplace, npm, or worktree installs; it runs phased setup rather than ad-hoc config edits.
How it compares
Official OMC installer workflow—not a generic dotfiles skill or third-party Claude prompt pack.
Common Questions / FAQ
Who is omc-setup for?
Solo developers using oh-my-claudecode on Claude Code who need install, update, or repair from the documented setup entrypoint.
When should I use omc-setup?
Immediately after /plugin install oh-my-claudecode, after npm i -g oh-my-claude-sisyphus@latest, or when local-dev worktree changes require rerunning setup.
Is omc-setup safe to install?
Review the Security Audits panel on this Prism page before running; setup touches Claude config directories and may use --force to overwrite prior state.
SKILL.md
READMESKILL.md - Omc Setup
# OMC Setup This is the **only command you need to learn**. After running this, everything else is automatic. **When this skill is invoked, immediately execute the workflow below. Do not only restate or summarize these instructions back to the user.** Note: All `~/.claude/...` paths in this guide respect `CLAUDE_CONFIG_DIR` when that environment variable is set. ## Best-Fit Use Choose this setup flow when the user wants to **install, refresh, or repair OMC itself**. - Marketplace/plugin install users should land here after `/plugin install oh-my-claudecode` - npm users should land here after `npm i -g oh-my-claude-sisyphus@latest` - local-dev and worktree users should land here after updating the checked-out repo and rerunning setup ## Flag Parsing Check for flags in the user's invocation: - `--help` → Show Help Text (below) and stop - `--local` → Phase 1 only (target=local), then stop - `--global` → Phase 1 only (target=global), then stop - `--force` → Skip Pre-Setup Check, run full setup (Phase 1 → 2 → 3 → 4) - No flags → Run Pre-Setup Check, then full setup if needed ## Help Text When user runs with `--help`, display this and stop: ``` OMC Setup - Configure oh-my-claudecode USAGE: /oh-my-claudecode:omc-setup Run initial setup wizard (or update if already configured) /oh-my-claudecode:omc-setup --local Configure local project (.claude/CLAUDE.md) /oh-my-claudecode:omc-setup --global Configure global settings (~/.claude/CLAUDE.md) /oh-my-claudecode:omc-setup --force Force full setup wizard even if already configured /oh-my-claudecode:omc-setup --help Show this help MODES: Initial Setup (no flags) - Interactive wizard for first-time setup - Configures CLAUDE.md (local or global) - Sets up HUD statusline - Checks for updates - Offers MCP server configuration - Configures team mode defaults (agent count, type, model) - If already configured, offers quick update option Local Configuration (--local) - Downloads fresh CLAUDE.md to ./.claude/ - Backs up existing CLAUDE.md to .claude/CLAUDE.md.backup.YYYY-MM-DD - Project-specific settings - Use this to update project config after OMC upgrades Global Configuration (--global) - Downloads fresh CLAUDE.md to ~/.claude/ - Backs up existing CLAUDE.md to ~/.claude/CLAUDE.md.backup.YYYY-MM-DD - Default: explicitly overwrites ~/.claude/CLAUDE.md so plain `claude` also uses OMC - Optional preserve mode keeps the user's base `CLAUDE.md` and installs OMC into `CLAUDE-omc.md` for `omc` launches - Applies to all Claude Code sessions - Cleans up legacy hooks - Use this to update global config after OMC upgrades Force Full Setup (--force) - Bypasses the "already configured" check - Runs the complete setup wizard from scratch - Use when you want to reconfigure preferences EXAMPLES: /oh-my-claudecode:omc-setup # First time setup (or update CLAUDE.md if configured) /oh-my-claudecode:omc-setup --local # Update this project /oh-my-claudecode:omc-setup --global # Update all projects /oh-my-claudecode:omc-setup --force # Re-run full setup wizard For more info: https://github.com/Yeachan-Heo/oh-my-claudecode ``` ## Pre-Setup Check: Already Configured? **CRITICAL**: Before doing anything else, check if setup has already been completed. This prevents users from having to re-run the full setup wizard after every update. ```bash # Check if setup was already completed CONFIG_FILE="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/.omc-config.json" if [ -f "$CONFIG_FILE" ]; then SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null) SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null) if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then echo "O