--- name: omc-setup-ae58c3227aa7 description: Install or refresh oh-my-claudecode for plugin, npm, and local-dev setups from the canonical setup flow level: 2 --- # 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 - 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="$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 "OMC setup was already completed on: $SETUP_COMPLETED" [ -n "$SETUP_VERSION" ] && echo "Setup version: $SETUP_VERSION" ALREADY_CONFIGURED="true" fi fi ``` ### If Already Configured (and no --force flag) If `ALREADY_CONFIGURED` is true AND the user did NOT pass `--force`, `--local`, or `--global` flags: Use AskUserQuestion to prompt: **Question:** "OMC is already configured. What would you like to do?" **Options:** 1. **Update CLAUDE.md only** - Download latest CLAUDE.md without re-running full setup 2. **Run full setup again** - Go through the complete setup wizard 3. **Cancel** - Exit without changes **If user chooses "Update CLAUDE.md only":** - Detect if local (.claude/CLAUDE.md) or global (~/.claude/CLAUDE.md) config exists - If local exists, run: `bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-claude-md.sh" local` - If only global exists, run: `bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-claude-md.sh" global` - Skip all other steps - Report success and exit **If user chooses "Run full setup again":** - Continue with Resume Detection below **If user chooses "Cancel":** - Exit without any changes ### Force Flag Override If user passes `--force` flag, skip this check and proceed directly to setup. ## Resume Detection Before starting any phase, check for existing state: ```bash bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-progress.sh" resume ``` If state exists (output is not "fresh"), use AskUserQuestion to prompt: **Question:** "Found a previous setup session. Would you like to resume or start fresh?" **Options:** 1. **Resume from step $LAST_STEP** - Continue where you left off 2. **Start fresh** - Begin from the beginning (clears saved state) If user chooses "Start fresh": ```bash bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-progress.sh" clear ``` ## Phase Execution ### For `--local` or `--global` flags: Read the file at `${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/01-install-claude-md.md` and follow its instructions. (The phase file handles early exit for flag mode.) ### For full setup (default or --force): Execute phases sequentially. For each phase, read the corresponding file and follow its instructions: 1. **Phase 1 - Install CLAUDE.md**: Read `${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/01-install-claude-md.md` and follow its instructions. 2. **Phase 2 - Environment Configuration**: Read `${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/02-configure.md` and follow its instructions. Phase 2 must delegate HUD/statusLine setup to the `hud` skill; do not generate or patch `statusLine` paths inline here. 3. **Phase 3 - Integration Setup**: Read `${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/03-integrations.md` and follow its instructions. 4. **Phase 4 - Completion**: Read `${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/04-welcome.md` and follow its instructions. ## Graceful Interrupt Handling **IMPORTANT**: This setup process saves progress after each phase via `${CLAUDE_PLUGIN_ROOT}/scripts/setup-progress.sh`. If interrupted (Ctrl+C or connection loss), the setup can resume from where it left off. ## Keeping Up to Date After installing oh-my-claudecode updates (via npm or plugin update): **Automatic**: Just run `/oh-my-claudecode:omc-setup` - it will detect you've already configured and offer a quick "Update CLAUDE.md only" option that skips the full wizard. **Manual options**: - `/oh-my-claudecode:omc-setup --local` to update project config only - `/oh-my-claudecode:omc-setup --global` to update global config only - `/oh-my-claudecode:omc-setup --force` to re-run the full wizard (reconfigure preferences) This ensures you have the newest features and agent configurations without the token cost of repeating the full setup. --- Source attribution: ClementATH Original project: https://github.com/ClementATH/oh-my-claudecode/blob/fae376508355fb03ea6a2477453f37f0a59e707f/skills/omc-setup/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2025 Yeachan Heo Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: ClementATH Original project: https://github.com/ClementATH/oh-my-claudecode/blob/fae376508355fb03ea6a2477453f37f0a59e707f/skills/omc-setup/SKILL.md Attribution basis: Source repository record Fields of work: Development & Engineering Roles: Backend Developer, DevOps / SRE, Full-Stack Developer Specialties: DevOps Tools: Oh My Claudecode Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 7f338cb99b41d4730b0559316c4596626b418f66caf621c07054d29a42b36609