oh-my-claude

Enhance Claude Code with context protection and specialized quality gates.

---

TL;DR — Skip This README

Just add a trigger word anywhere in your prompt:

fix all the type errors, ultrawork
ultraresearch best practices for API design

Claude will parallelize everything, delegate file reads to subagents, track progress with todos, and refuse to stop until the job is done. No partial implementations. No asking for permission. Just execution.

Install it and start using it. Come back here when you want the details.

---

Table of Contents

• Why This Exists
• Install
• Magic Keywords
• What Ultrawork Actually Does
• The Agent Team
• Enhanced Plan Mode
• All Components
• Integrations
• For LLM Agents
• Philosophy
• Contributing
• Uninstall

---

Why This Exists

Claude Code is already intelligent. oh-my-claude makes it even better by:

• Protecting your context — Delegates file reading to subagents so your main session stays sharp
• Adding quality gates — Specialized agents for gap analysis, plan review, and validation
• Working invisibly — Hooks run in the background; you get a better experience just for having it installed
• Staying out of the way — Enhances Claude's capabilities without conflicting with its built-in intelligence

Install it and forget it. Your context is protected. Your plans get reviewed. Your work gets validated.

---

Install

Supported on macOS and Linux. Windows support is planned.

Step 1: Install uv (required)

curl -LsSf https://astral.sh/uv/install.sh | sh

uv manages Python automatically. No separate Python install needed.

Step 2: Install the plugin

# In Claude Code:
/plugin marketplace add TechDufus/oh-my-claude
/plugin install oh-my-claude@oh-my-claude

Alternative: From Local Directory

git clone https://github.com/TechDufus/oh-my-claude /tmp/oh-my-claude
# In Claude Code:
/plugin marketplace add /tmp/oh-my-claude
/plugin install oh-my-claude@oh-my-claude

Step 3: Restart Claude Code

Required for hooks to activate.

Update

# Refresh marketplace
/plugin marketplace update oh-my-claude

# Update to latest version
/plugin update oh-my-claude@oh-my-claude

---

Magic Keywords

Keyword	Shortcut	Effect
ultrawork	ulw	Maximum parallel execution — won't stop until done
ultraresearch	ulr	Exhaust online sources — parallel WebSearch, cross-reference, cite everything
ultradebug	uld	Systematic 7-step debugging with evidence-based diagnosis

---

What Ultrawork Actually Does

When you prefix a prompt with ultrawork, Claude's behavior changes fundamentally:

Behavior	Normal Mode	Ultrawork Mode
Task execution	Sequential, one at a time	Parallel — multiple subagents in ONE message
File reading	Loads into main context	Delegated — librarian subagent reads, you get summaries
Progress tracking	Optional	Mandatory — TodoWrite immediately, update in real-time
Stopping condition	After each step	Only when ALL todos complete AND validation passes
Partial solutions	Accepted	Zero tolerance — full implementation or nothing
Asking permission	Frequent	Never — makes reasonable decisions, documents them

The hook intercepts your prompt, detects the keyword, and injects context that guides Claude toward quality gates and parallel execution.

---

The Agent Team

Specialized subagents complement Claude Code's built-in agents: