oh-my-claude-code

oh-my-claude-code

Multi-agent orchestration for Claude Code, inspired by oh-my-opencode

English | 中文

Version: 1.2.0 | Changelog | ROADMAP

A Claude Code plugin providing specialized agents that work together through intelligent delegation.

Overview

oh-my-claude-code brings the power of multi-agent orchestration to Claude Code. It provides:

• Specialized Agents - Each agent excels at a specific domain
• Intelligent Delegation - The orchestrator routes tasks to the right agent
• Cost-Aware Selection - FREE → CHEAP → EXPENSIVE decision framework
• Structured Metadata - YAML-based agent definitions with rich metadata
• Ultrawork Mode - Obsessive task completion with ulw magic keyword
• Todo Continuation - Sisyphus-style enforcement to complete all tasks

v1.2.0 Architecture Improvements

• Centralized Configuration - All config managed in config/index.js
• Parameter Validation - Type-safe validation with helpful error messages
• Progress Visualization - Beautiful progress bars and time estimates
• Performance Optimized - Parallel PostToolUse processing (~40% faster)
• Modular Utils - Reusable validation, patterns, and progress reporting

Installation

From Marketplace (Recommended)

# Add the marketplace
/plugin marketplace add https://github.com/zephyrpersonal/oh-my-claude-code

# Install the plugin
/plugin install oh-my-claude-code@oh-my-claude-code-plugins

Local Installation (For Development)

1. Clone the repository:

git clone https://github.com/zephyrpersonal/oh-my-claude-code.git

2. Add local marketplace and install:

/plugin marketplace add ./oh-my-claude-code
/plugin install oh-my-claude-code@oh-my-claude-code-plugins

Plugin Structure

oh-my-claude-code/
├── .claude-plugin/
│   ├── plugin.json           # Plugin manifest
│   └── marketplace.json      # Local marketplace config
├── hooks/
│   ├── hooks.json            # Hooks configuration
│   ├── ultrawork-detector.js # Detects ulw keyword
│   ├── todo-continuation-enforcer.js
│   └── post-tool-processor.js # Unified PostToolUse handler
├── config/
│   └── index.js              # Centralized configuration
├── utils/
│   ├── validation.js         # Parameter validation
│   ├── patterns.js           # Pre-compiled regex
│   └── progress-reporter.js  # Progress visualization
├── commands/
│   └── ulw.md                # Slash command
├── agents/
│   ├── orchestrator.md
│   ├── explore.md
│   ├── librarian.md
│   └── ...
├── skills/
│   └── ultrawork/
│       └── SKILL.md
├── docs/
│   └── WEEK1-2-SUMMARY.md    # Development summaries
├── ROADMAP.md                # 48-week iteration plan
└── package.json

Agents

Agent	Model	Cost	Purpose
orchestrator	inherit	EXPENSIVE	Task classification and delegation
explore	haiku	FREE	Internal codebase search
librarian	sonnet	CHEAP	External docs and research
oracle	opus	EXPENSIVE	Architecture and deep analysis
frontend-ui-ux-engineer	sonnet	CHEAP	Visual/UI changes
document-writer	sonnet	CHEAP	Technical documentation
multimodal-looker	sonnet	CHEAP	PDF/image analysis

See AGENTS.md for detailed information about each agent.

Ultrawork Mode (Sisyphus Mode)

Ultrawork is a special mode that enables obsessive task completion.

Activation

Add ulw, ultrawork, or uw anywhere in your message:

claude "Implement user authentication, ulw"
claude "ulw refactor the database layer"

Parameters

ULW supports optional parameters for fine-tuned control:

Parameter	Default	Description
--max-iterations N	50	Maximum continuation attempts
--thoroughness LEVEL	thorough	Search depth: quick, medium, thorough
--no-diagnostics	(enabled)	Disable auto-diagnostics reminders
--completion-signal "TEXT"	(none)	Custom completion signal phrase

Examples:

# Limit iterations
claude "implement auth, ulw --max-iterations 20"

# Custom completion signal
claude "add tests ulw --completion-signal 'all tests pass'"

# Quick search mode
claude "ulw --thoroughness quick fix the typo"

# Combined parameters
claude "refactor cache layer, ulw --max-iterations 30 --thoroughness medium"

What It Does

• Creates comprehensive todo lists for every task
• Does NOT stop until ALL todos are complete
• Uses maximum thoroughness for searches
• Verifies every change with diagnostics
• Automatically continues if stopped with incomplete tasks

The Sisyphus Promise

"Like Sisyphus, you roll the boulder every day. You don't stop until you reach the top."

ULW vs Ralph Loop