How OMC Works
You don't need to learn any commands! OMC enhances Claude Code with intelligent behaviors that activate automatically.
What Happens Automatically
When You... I Automatically...
Give me a complex task Parallelize and delegate to specialist agents
Ask me to plan something Start a planning interview
Need something done completely Persist until verified complete
Work on UI/frontend Activate design sensibility
Say "stop" or "cancel" Intelligently stop current operation
Magic Keywords (Optional Shortcuts)
You can include these words naturally in your request for explicit control:
Keyword Effect Example
ralph Persistence mode "ralph: fix all the bugs"
ralplan Iterative planning "ralplan this feature"
ulw Max parallelism "ulw refactor the API"
plan Planning interview "plan the new endpoints"
ralph includes ultrawork: When you activate ralph mode, it automatically includes ultrawork's parallel execution. No need to combine keywords.
Stopping Things
Just say:
-
"stop"
-
"cancel"
-
"abort"
I'll figure out what to stop based on context.
First Time Setup
If you haven't configured OMC yet:
/oh-my-claudecode:omc-setup
This is the only command you need to know. It downloads the configuration and you're done.
For 2.x Users
Your old commands still work! /ralph , /ultrawork , /plan , etc. all function exactly as before.
But now you don't NEED them - everything is automatic.
Usage Analysis
Analyze your oh-my-claudecode usage and get tailored recommendations to improve your workflow.
Note: This replaces the former /oh-my-claudecode:learn-about-omc skill.
What It Does
-
Reads token tracking from ~/.omc/state/token-tracking.jsonl
-
Reads session history from .omc/state/session-history.json
-
Analyzes agent usage patterns
-
Identifies underutilized features
-
Recommends configuration changes
Step 1: Gather Data
Check for token tracking data
TOKEN_FILE="$HOME/.omc/state/token-tracking.jsonl" SESSION_FILE=".omc/state/session-history.json" CONFIG_FILE="$HOME/.claude/.omc-config.json"
echo "Analyzing OMC Usage..." echo ""
Check what data is available
HAS_TOKENS=false HAS_SESSIONS=false HAS_CONFIG=false
if [[ -f "$TOKEN_FILE" ]]; then HAS_TOKENS=true TOKEN_COUNT=$(wc -l < "$TOKEN_FILE") echo "Token records found: $TOKEN_COUNT" fi
if [[ -f "$SESSION_FILE" ]]; then HAS_SESSIONS=true SESSION_COUNT=$(cat "$SESSION_FILE" | jq '.sessions | length' 2>/dev/null || echo "0") echo "Sessions found: $SESSION_COUNT" fi
if [[ -f "$CONFIG_FILE" ]]; then HAS_CONFIG=true DEFAULT_MODE=$(cat "$CONFIG_FILE" | jq -r '.defaultExecutionMode // "not set"') echo "Default execution mode: $DEFAULT_MODE" fi
Step 2: Analyze Agent Usage (if token data exists)
if [[ "$HAS_TOKENS" == "true" ]]; then echo "" echo "TOP AGENTS BY USAGE:" cat "$TOKEN_FILE" | jq -r '.agentName // "main"' | sort | uniq -c | sort -rn | head -10
echo "" echo "MODEL DISTRIBUTION:" cat "$TOKEN_FILE" | jq -r '.modelName' | sort | uniq -c | sort -rn fi
Step 3: Generate Recommendations
Based on patterns found, output recommendations:
If high Opus usage (>40%) and no ecomode:
- "Consider using ecomode for routine tasks to save tokens"
If no pipeline usage:
- "Try /pipeline for code review workflows"
If no security-reviewer usage:
- "Use security-reviewer after auth/API changes"
If defaultExecutionMode not set:
- "Set defaultExecutionMode in /omc-setup for consistent behavior"
Step 4: Output Report
Format a summary with:
-
Token summary (total, by model)
-
Top agents used
-
Underutilized features
-
Personalized recommendations
Example Output
📊 Your OMC Usage Analysis
TOKEN SUMMARY:
- Total records: 1,234
- By Model: opus 45%, sonnet 40%, haiku 15%
TOP AGENTS:
- executor (234 uses)
- architect (89 uses)
- explore (67 uses)
UNDERUTILIZED FEATURES:
- ecomode: 0 uses (could save ~30% on routine tasks)
- pipeline: 0 uses (great for review workflows)
RECOMMENDATIONS:
- Set defaultExecutionMode: "ecomode" to save tokens
- Try /pipeline review for PR reviews
- Use explore agent before architect to save context
Graceful Degradation
If no data found:
📊 Limited Usage Data Available
No token tracking found. To enable tracking:
- Ensure ~/.omc/state/ directory exists
- Run any OMC command to start tracking
Tip: Run /omc-setup to configure OMC properly.
Need More Help?
Version: 4.2.3