Oh My ClaudeCode

https://github.com/yeachan-heo/oh-my-claudecode
Admin
Oh My ClaudeCode is a multi-agent orchestration system for Claude Code that enables...
Tokens:775,073
Snippets:5,314
Trust Score:9.4
License:MIT
Update:1 week ago
Show doc for...
Tokens:
Raw
### Get Started Commands

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/slides.md

Commands to add the plugin marketplace, install the plugin, and start using autopilot.

```text
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
autopilot: build something amazing
```

--------------------------------

### Install OMC and Run Setup

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/notes.md

Three-step installation process: install OMC globally, run the setup wizard via Claude Code, and start using it with an autopilot command.

```bash
# Step 1: Install OMC
npm install -g oh-my-claudecode

# Step 2: Run setup wizard
claude-code "/oh-my-claudecode:omc-setup"

# Step 3: Start using it
claude-code "autopilot: build me a todo app"
```

--------------------------------

### Quick Start Commands

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/README.md

Run the one-time setup, a quick sanity test with 5 instances, and the full comparison.

```bash
# 1. One-time setup
./setup.sh

# 2. Quick sanity test (5 instances)
./quick_test.sh

# 3. Full comparison
./run_full_comparison.sh
```

--------------------------------

### processSetupInit example

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/src/hooks/setup/README.md

Processes setup initialization. Takes a SetupInput object with session_id, transcript_path, cwd, permission_mode, hook_event_name, and trigger.

```typescript
const result = await processSetupInit({
  session_id: 'abc123',
  transcript_path: '/tmp/transcript.md',
  cwd: '/path/to/project',
  permission_mode: 'normal',
  hook_event_name: 'Setup',
  trigger: 'init'
});
```

--------------------------------

### Flow B: Marketplace setup

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/CONTRIBUTING.md

Adds local directory as marketplace source, installs plugin, and runs /setup.

```bash
claude plugin marketplace add /path/to/oh-my-claudecode

claude plugin install oh-my-claudecode@oh-my-claudecode

/setup
```

--------------------------------

### Start server with npm install && npm run dev

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/screenshots/README.md

Command shown in the autopilot phases slide to start the server after validations are approved.

```bash
npm install && npm run dev
```

--------------------------------

### processSetupMaintenance example

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/src/hooks/setup/README.md

Processes setup maintenance. Takes a SetupInput object with session_id, transcript_path, cwd, permission_mode, hook_event_name, and trigger.

```typescript
const result = await processSetupMaintenance({
  session_id: 'abc123',
  transcript_path: '/tmp/transcript.md',
  cwd: '/path/to/project',
  permission_mode: 'normal',
  hook_event_name: 'Setup',
  trigger: 'maintenance'
});
```

--------------------------------

### Setup commands for demo workspace

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/demos/demo-4-planning.md

Commands to create and navigate to a demo workspace directory. Can start with an empty or minimal structure; planning will ask what you want.

```bash
cd ~/demo-workspace
mkdir -p auth-system-demo
cd auth-system-demo

# Can start with empty directory or minimal structure
# Planning will ask what you want
```

--------------------------------

### setup.sh Usage

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/README.md

Run the one-time setup script to install dependencies, build the Docker image, download the dataset, verify the API key, build the OMC project, and run sanity checks.

```bash
./setup.sh
```

--------------------------------

### Check for existing setup state

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/skills/omc-setup/SKILL.md

Run this command before starting any phase to check for existing setup state. If the output is not "fresh", a previous session exists and the user should be prompted to resume or start fresh.

```bash
bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" resume
```

--------------------------------

### Build with Autopilot

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/slides.md

Example command to start building a REST API using autopilot.

```text
autopilot: build a REST API for managing tasks
```

--------------------------------

### Flow C: Setup with --no-plugin

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/CONTRIBUTING.md

Fallback flow that skips plugin system and installs agents/skills to home directory.

```bash
omc --plugin-dir "$PWD" setup --no-plugin
```

--------------------------------

### Environment Preparation: Create demo workspace and verify OMC

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/demos/README.md

Commands to create a demo workspace, verify OMC installation, and check HUD status. Run these before starting demos.

```bash
# Create demo workspace
mkdir -p ~/demo-workspace
cd ~/demo-workspace

# Verify OMC is installed
which omc || echo "Run: /oh-my-claudecode:omc-setup"

# Check HUD is working
echo "HUD should display in your terminal prompt"
```

--------------------------------

### Setup: Create clean workspace and clear OMC state

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/demos/demo-1-autopilot.md

Commands to create a clean demo directory, verify it's empty, and remove any previous OMC state before starting the autopilot demo.

```bash
# Create clean workspace
mkdir -p ~/demo-workspace/bookstore-api
cd ~/demo-workspace/bookstore-api

# Verify clean state
ls -la  # Should be empty

# Clear any previous OMC state
rm -rf .omc
```

--------------------------------

### Getting Help Commands

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/slides.pdf

Slash commands to get usage guide and diagnose issues.

```text
/oh-my-claudecode:help-Usage guide
/oh-my-claudecode:doctor-Diagnose issues
```

--------------------------------

### processSetup example

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/src/hooks/setup/README.md

Generic entry point that routes to init or maintenance based on trigger. Takes a SetupInput object with session_id, transcript_path, cwd, permission_mode, hook_event_name, and trigger.

```typescript
const result = await processSetup({
  session_id: 'abc123',
  transcript_path: '/tmp/transcript.md',
  cwd: '/path/to/project',
  permission_mode: 'normal',
  hook_event_name: 'Setup',
  trigger: 'init' // or 'maintenance'
});
```

--------------------------------

### Install oh-my-claudecode plugin

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/quickref.md

Commands to add and install the plugin from the GitHub repository, then run the setup command.

```bash
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode
/oh-my-claudecode:omc-setup
```

--------------------------------

### processSetupInit(input: SetupInput): Promise<HookOutput>

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/src/hooks/setup/README.md

Processes setup initialization.

```APIDOC
## processSetupInit(input: SetupInput): Promise<HookOutput>

### Description
Processes setup initialization.

### Parameters
- **input** (SetupInput) - Required - The setup input object containing session and trigger information.

### Returns
Promise resolving to HookOutput.

### Example
```typescript
const result = await processSetupInit({
  session_id: 'abc123',
  transcript_path: '/tmp/transcript.md',
  cwd: '/path/to/project',
  permission_mode: 'normal',
  hook_event_name: 'Setup',
  trigger: 'init'
});
```
```

--------------------------------

### Install Terminal CLI

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/REFERENCE.md

Installs the omc CLI globally via npm and runs setup. The CLI does not provide in-session slash skills; install the plugin for those.

```bash
npm i -g oh-my-claude-sisyphus@latest
omc setup
```

--------------------------------

### Getting Help Command

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/slides.md

Shows the usage guide command for OMC.

```text
/oh-my-claudecode:omc-help    - Usage guide
```

--------------------------------

### processSetup(input: SetupInput): Promise<HookOutput>

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/src/hooks/setup/README.md

Generic entry point that routes to init or maintenance based on trigger.

```APIDOC
## processSetup(input: SetupInput): Promise<HookOutput>

### Description
Generic entry point that routes to init or maintenance based on trigger.

### Parameters
- **input** (SetupInput) - Required - The setup input object containing session and trigger information.

### Returns
Promise resolving to HookOutput.

### Example
```typescript
const result = await processSetup({
  session_id: 'abc123',
  transcript_path: '/tmp/transcript.md',
  cwd: '/path/to/project',
  permission_mode: 'normal',
  hook_event_name: 'Setup',
  trigger: 'init' // or 'maintenance'
});
```
```

--------------------------------

### Install SWE-bench and oh-my-claudecode

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/results/README.md

Install the SWE-bench package and optionally oh-my-claudecode for OMC testing. The second command is a placeholder comment; follow the main README for setup instructions.

```bash
# Install SWE-bench
pip install swebench

# Install oh-my-claudecode (if testing OMC)
# Follow setup instructions in main README
```

--------------------------------

### Autopilot Vague Input Redirect Example

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/skills/deep-interview/SKILL.md

Example interaction showing how autopilot redirects vague user input to deep-interview, offering options to start an interview or expand directly.

```text
User: "autopilot build me a thing"
Autopilot: "Your request is quite open-ended. Would you like to run a deep interview first to clarify requirements?"
  [Yes, interview first] [No, expand directly]
```

--------------------------------

### run_vanilla.sh Examples

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/README.md

Examples of running run_vanilla.sh with different options: full benchmark, limit 100, skip 100 and limit 100, and timeout 600.

```bash
./run_vanilla.sh                           # Full benchmark
./run_vanilla.sh --limit 100               # First 100 instances
./run_vanilla.sh --skip 100 --limit 100    # Instances 101-200
./run_vanilla.sh --timeout 600             # 10 minutes per instance
```

--------------------------------

### HUD statusline example output

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/notes.md

Example output from the OMC HUD showing the active mode, number of agents, and their current tasks. This is displayed in the shell prompt after running the setup command.

```plaintext
[OMC] Mode: ultrawork | Agents: 3 active | executor-1: fixing auth.ts | executor-2: fixing api.ts | architect: reviewing
```

--------------------------------

### Run setup script and check for errors

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/README.md

Executes the setup script and advises checking the output for specific errors.

```bash
./setup.sh
# Check output for specific errors
```

--------------------------------

### Autopilot Usage Example

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/FEATURES.md

TypeScript example showing how to initialize an autopilot session, get phase prompts, monitor progress, transition phases, and generate summaries. Uses functions from '@/hooks/autopilot'.

```typescript
import {
  initAutopilot,
  getPhasePrompt,
  readAutopilotState,
  transitionRalphToUltraQA,
  getValidationStatus,
  generateSummary,
  formatSummary
} from '@/hooks/autopilot';

// Initialize session
const idea = 'Create a REST API for todo management with authentication';
const state = initAutopilot(process.cwd(), idea, 'ses_abc123');

// Get expansion phase prompt
const prompt = getPhasePrompt('expansion', { idea });

// Monitor progress
const currentState = readAutopilotState(process.cwd());
console.log(`Phase: ${currentState?.phase}`);
console.log(`Agents spawned: ${currentState?.total_agents_spawned}`);

// Transition phases
if (currentState?.phase === 'execution' && currentState.execution.ralph_completed_at) {
  const result = transitionRalphToUltraQA(process.cwd(), 'ses_abc123');
  if (result.success) {
    console.log('Transitioned to QA phase');
  }
}

// Check validation
const validationStatus = getValidationStatus(process.cwd());
if (validationStatus?.allApproved) {
  const summary = generateSummary(process.cwd());
  if (summary) {
    console.log(formatSummary(summary));
  }
}
```

--------------------------------

### Session Replay JSONL Events

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/PERFORMANCE-MONITORING.md

Example JSONL events from session replay files, showing agent start, tool start, and tool end events with timing and success status.

```json
{"t":0.0,"agent":"a1b2c3d","agent_type":"executor","event":"agent_start","task":"Implement feature","parent_mode":"team"}
{"t":5.2,"agent":"a1b2c3d","event":"tool_start","tool":"Read"}
{"t":5.4,"agent":"a1b2c3d","event":"tool_end","tool":"Read","duration_ms":200,"success":true}
```

--------------------------------

### initPlanNotepad

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/FEATURES.md

Initializes a notepad directory for a given plan. Creates the directory structure with four markdown files if it does not exist.

```APIDOC
## initPlanNotepad

### Description
Initializes a notepad directory for a given plan. Creates the directory structure with four markdown files if it does not exist.

### Method
Function

### Signature
`initPlanNotepad(planName: string, directory?: string): boolean`

### Parameters
- **planName** (string) - Required - The name of the plan.
- **directory** (string) - Optional - The base directory for the notepad. Defaults to `.omc/notepads/`.

### Returns
- **boolean** - `true` if initialization succeeded, `false` otherwise.

### Example
```typescript
import { initPlanNotepad } from '@/features/notepad-wisdom';

initPlanNotepad('api-v2-migration');
```
```

--------------------------------

### quick_test.sh Examples

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/README.md

Examples of running quick_test.sh with different options: default 5 instances, limit 10, and timeout 300 seconds.

```bash
./quick_test.sh                    # Test 5 instances
./quick_test.sh --limit 10         # Test 10 instances
./quick_test.sh --timeout 300      # 5 minutes per instance
```

--------------------------------

### Quick Install Commands

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/LOCAL_PLUGIN_INSTALL.md

Adds the local directory as a marketplace, installs the plugin, runs /setup, and restarts Claude Code. Use for local development checkouts and git worktrees.

```bash
# 1. Add local directory as a marketplace
claude plugin marketplace add /path/to/oh-my-claudecode

# 2. Install the plugin from the local marketplace
claude plugin install oh-my-claudecode@oh-my-claudecode

# 3. Re-run setup inside Claude Code so CLAUDE.md / skills reflect this checkout
/setup

# 4. Restart Claude Code to pick up the plugin
```

--------------------------------

### run_full_comparison.sh Examples

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/benchmark/README.md

Examples of running run_full_comparison.sh: full comparison, limit 100, and skip vanilla.

```bash
./run_full_comparison.sh                    # Full comparison
./run_full_comparison.sh --limit 100        # Test 100 instances
./run_full_comparison.sh --skip-vanilla     # Only run OMC (reuse vanilla results)
```

--------------------------------

### Manual Git Clone Installation

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/seminar/slides.pdf

Clone the repository, navigate into it, and build the project.

```shell
git clone https://github.com/Yeachan-Heo/oh-my-claudecode.git cd oh-my-claudecode npm install && npm run build
```

--------------------------------

### lsp_hover - Get type information and documentation

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/TOOLS.md

Returns type information and documentation at the specified position. Requires a language server to be installed.

```text
lsp_hover(file="src/auth.ts", line=42, character=10)
```

--------------------------------

### Update OMC via Claude Code marketplace

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/README.md

Update OMC when installed via the Claude Code marketplace/plugin flow. First update the marketplace clone, then re-run setup to refresh configuration. If marketplace auto-update is not enabled, you must manually run /plugin marketplace update omc before setup.

```bash
# 1. Update the marketplace clone
/plugin marketplace update omc

# 2. Re-run setup to refresh configuration
/omc-setup
```

--------------------------------

### Notepad Wisdom System Usage Example

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/docs/FEATURES.md

Shows how to use the Notepad Wisdom System: import the functions, initialize a notepad for a plan, add a learning entry, and read back the wisdom. The example uses the plan name 'api-v2-migration' and demonstrates accessing the first learning entry's content.

```typescript
import { initPlanNotepad, addLearning, readPlanWisdom } from '@/features/notepad-wisdom';

// Initialize and record
initPlanNotepad('api-v2-migration');
addLearning('api-v2-migration', 'API routes use Express Router pattern in src/routes/');

// Read back
const wisdom = readPlanWisdom('api-v2-migration');
console.log(wisdom.learnings[0].content);
```

--------------------------------

### Run the vendor MCP server

Source: https://github.com/yeachan-heo/oh-my-claudecode/blob/main/examples/vendor-mcp-server/README.md

Starts the reference server from the repo root using Node.js.

```bash
node examples/vendor-mcp-server/server.mjs
```
Tokens:
Raw