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.