omca-setup

Configure Claude Code settings, dependencies, and statusline for the oh-my-claudeagent plugin.

1|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/UtsavBalar1231/oh-my-claudeagent --skill omca-setup-utsavbalar1231
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omca-setup
Source: https://github.com/UtsavBalar1231/oh-my-claudeagent/tree/main/skills/omca-setup
Command: npx skills add https://github.com/UtsavBalar1231/oh-my-claudeagent --skill omca-setup-utsavbalar1231

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the oh-my-claudeagent multi-agent plugin requires checking dependencies, injecting orchestration blocks into CLAUDE.md, configuring settings.json permissions, and deploying a statusline — all error-prone manual steps. This Skill automates the entire configuration, diagnosis, and uninstall flow in one command. ## Core Features & Use Cases - Dependency Verification: Checks jq, uv, python3, and ast-grep availability and reports PASS/WARN/FAIL before any changes are made. - Idempotent CLAUDE.md Injection: Backs up the existing file, migrates legacy blocks, and injects the orchestration template between detectable markers so re-runs are safe. - Settings & Statusline Configuration: Merges recommended permission rules, deploys the statusline package with uv sync, and supports daemon or direct modes plus subagent statusline. - Diagnostic Modes: Use --check or --doctor for read-only health reports, and --uninstall to cleanly remove the plugin configuration. - Use Case: After installing the plugin from the marketplace, run the setup once to verify dependencies, configure ~/.claude/, and get a health report with git commit and plugin state. ## Quick Start Ask the AI to run omca-setup to configure the oh-my-claudeagent plugin and verify all dependencies are installed.

Frequently Asked Questions about omca-setup

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

FAQPage Schema
How do I set up the oh-my-claudeagent plugin in Claude Code?

Install the plugin from the marketplace, then run the omca-setup skill. It checks dependencies (jq, uv, python3, ast-grep), injects the orchestration block into ~/.claude/CLAUDE.md, and optionally configures settings.json permissions and the statusline.

How do I diagnose a broken oh-my-claudeagent installation?

Run omca-setup with the --check or --doctor flag. These modes produce a read-only health report covering dependency versions, plugin state, and configuration without modifying any files.

What dependencies does oh-my-claudeagent require?

The plugin requires jq for hooks, uv for MCP servers, and python3 3.10 or later. ast-grep (or the sg binary) is optional but needed for structural code search MCP tools.

Does omca-setup modify my existing CLAUDE.md content?

No. It creates a backup at CLAUDE.md.bak, removes only legacy OMCA marker blocks, and preserves all user content verbatim. The orchestration block is injected between detectable markers so re-runs are idempotent.

Can I use my own output style instead of the OMCA default?

Yes. Set the disableForceOrchestrationStyle plugin option to true, and setup strips the force-for-plugin line from the cached style file so your own outputStyle takes precedence. Re-run setup after each plugin update.

How do I uninstall oh-my-claudeagent cleanly?

Run omca-setup with the --uninstall flag. This switches the skill into uninstall mode, which removes the injected configuration rather than performing setup.