omc-setup

Install or refresh oh-my-claudecode and CLAUDE.md across plugin, npm, and local-dev environments.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/INNERJOINT/HarnessSkills --skill omc-setup-innerjoint
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omc-setup
Source: https://github.com/INNERJOINT/HarnessSkills/tree/main/skills/omc-setup
Command: npx skills add https://github.com/INNERJOINT/HarnessSkills --skill omc-setup-innerjoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates installing, refreshing, or repairing the oh-my-claudecode (OMC) plugin and its configuration files so users do not have to manually update CLAUDE.md, settings.json, HUD hooks, or CLI helpers across different installation flows.

Core Features & Use Cases

  • Phased, resumable setup: Runs a multi-phase wizard (install CLAUDE.md, environment configuration, integrations, completion) with resume detection and progress saving so interrupted installs can continue safely.
  • Flag-driven modes and validation: Supports --local, --global, and --force modes, validates OMC markers in downloaded CLAUDE.md, backs up existing files, and verifies settings.json integrity after edits.
  • Delegation and integration: Delegates HUD/statusline setup to the hud skill, offers optional MCP server and agent-team configuration, and optionally installs the OMC CLI to provide standalone helpers.
  • Use case: Use this when you need to install OMC for the first time, update project/global CLAUDE.md after an update, repair a broken configuration, or enable experimental features like agent teams.

Quick Start

Run the omc-setup skill to install or update oh-my-claudecode and its CLAUDE.md configuration.

Frequently Asked Questions about omc-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and configure the oh-my-claudecode plugin in my project?▼

To install oh-my-claudecode, run the omc-setup skill which executes a multi-phase wizard to install CLAUDE.md, configure environments, set up integrations, and validate settings.json integrity automatically.

Why does my CLAUDE.md configuration break after updating oh-my-claudecode?▼

If your CLAUDE.md configuration breaks after an oh-my-claudecode update, run the omc-setup skill to repair it by validating OMC markers, restoring backups, and verifying CLI installation state.

Can I resume an interrupted oh-my-claudecode setup without losing progress?▼

Yes, you can resume an interrupted oh-my-claudecode setup because the process features resume detection and saves progress via setup-progress.sh, allowing safely continuing from the last completed phase.

What is the difference between local and global oh-my-claudecode installation modes?▼

Local and global oh-my-claudecode installation modes target project-specific versus system-wide configurations respectively, both configurable via --local, --global, and --force flags while respecting CLAUDE_CONFIG_DIR.

Does oh-my-claudecode setup include configuring the HUD and MCP servers?▼

Yes, oh-my-claudecode setup includes configuring the HUD by delegating to the hud skill, and offers optional MCP server and agent-team configuration during the integrations phase.

What is the best way to automate refreshing CLAUDE.md and settings across plugin environments?▼

The best way to automate refreshing CLAUDE.md and settings across plugin, npm, and local-dev environments is using the omc-setup skill's flag-driven phased execution with automatic backups and validation.