oh-my-claude

---

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 strong. oh-my-claude pushes it harder by:

• Coaching delegation — Pushes heavy reading and side quests into 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 plans get reviewed. Your work gets validated. Claude stays focused.

---

Install

Supported on macOS, Linux, and Windows when uv is available on PATH.

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: Reload plugins or restart Claude Code

/reload-plugins is enough on newer Claude Code builds. Restart still works everywhere.

Compatibility note: If you're on Claude Code <= 2.1.62, this repo's examples use the newer Agent(...) name, but your build may still show Task(...). Use Task(...) on older builds or update Claude Code.

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:

Agent	What It Does
advisor	Pre-planning gap analysis for hidden requirements and scope risks
risk-assessor	Change-risk assessment for plans and diffs across app/dependency/infra concerns
critic	Plan review — finds flaws and edge cases BEFORE execution
librarian	Smart reading — summarizes large files, git diffs and changelogs
validator	QA — runs tests, linters, type checks, reports pass/fail
code-reviewer	Implementation review after code is written
security-auditor	Security-focused review for exploitable code and dependency risks

Claude Code Built-in Agents

Claude Code provides these agents out of the box, which oh-my-claude leverages:

Built-in Agent	What It Does
Explore	Find files, search codebase, locate definitions
Plan	Design implementation approaches, decompose complex tasks
general-purpose	General-purpose implementation tasks

Usage

Agent(subagent_type="oh-my-claude:librarian", prompt="Summarize src/auth/service.ts")
Agent(subagent_type="oh-my-claude:risk-assessor", prompt="Assess risk for this migration plan")
Agent(subagent_type="oh-my-claude:critic", prompt="Review this implementation plan for flaws")
Agent(subagent_type="general-purpose", prompt="Add password reset endpoint")
Agent(subagent_type="oh-my-claude:validator", prompt="Run all tests and report results")

Why Subagents Matter

Subagent context is isolated from your main context. When a librarian reads a 2000-line file, those lines don't consume your context window — you get a summary. This keeps your main Claude sharp for reasoning instead of drowning in file contents.

Claude Code renamed the spawn tool from Task(...) to Agent(...) in v2.1.63. Task(...) still works as an alias on modern builds, but this repo now uses Agent(...) in examples and docs.

---

Enhanced Plan Mode

Enter plan mode (Shift+Tab) and get a structured 7-step pipeline automatically — no magic words needed:

1. Recon — Explore and librarian gather codebase context before questions
2. Interview — Smart, recon-informed questions (not generic prompts)
3. Research — Targeted deep research informed by your answers
4. Gap Analysis — Advisor agent catches hidden assumptions and scope risks
5. Risk Pass — Risk-assessor evaluates cross-stack change risk before approval
6. Write Plan — Structured plan with file:line refs, decisions, and risks
7. Critic Review — Critic must approve before plan exits

Cross-session continuity means "Accept and clear" carries the full execution context into the next session automatically.

Optional keyword modes — drop these in your prompt for specialized behavior:

Keyword	Shortcut	What It Does
ultrawork	ulw	Maximum execution intensity with relentless task tracking
ultraresearch	ulr	Systematic parallel research with cross-referencing and citations
ultradebug	uld	Forensic debugging with multiple hypotheses and 3-strike escalation

---

All Components

Hooks (Automatic)

Hook	When	What
context-guardian	Session start	Injects context protection rules
ultrawork-detector	Prompt submit	Detects keywords, injects execution directives
safe-permissions	Permission request	Auto-approves safe commands (tests, linters, readonly)
todo-enforcer	Stop	Prevents stopping with incomplete todos
context-monitor	Post tool use	Warns at high context usage
verification-reminder	Post agent use	Reminds Claude to verify delegated work before claiming done
precompact-context	Pre compact	Preserves session state before compaction

Commands

Command	Description
/prime	Context recovery after /clear

Skills

Skill	Trigger
git-commit-validator	Commit requests — "commit", "ship it", "push this"
pr-creation	PR requests — "create PR", "open PR", "ready for review"
worktree	/worktree — Git worktree automation for isolated development
init-deep	/init-deep — Initialize nested CLAUDE.md structure
ralph-plan	/ralph-plan <topic> — Structured PRD generation with interview and research
ralph-loop-init	/ralph-loop-init — Transform approved plans into ralph loop infrastructure
debugger	/debugger — Systematic debugging methodology guidance
tdd	Test-first implementation methodology
verification	Evidence-based completion checks
receiving-code-review	Technical handling of review feedback
writing-skills	Skill authoring methodology
oh-my-claude-runtime	Runtime workflow guidance for ultrawork, orchestration, and plugin configuration

---

Integrations

OpenKanban

OpenKanban is a TUI kanban board for orchestrating AI coding agents. When you run Claude Code in an OpenKanban-managed terminal, oh-my-claude automatically reports live status updates.

Status	When
idle	Session started, ready for input
working	Processing prompt or executing tools
waiting	Awaiting user permission

How it works: OpenKanban sets OPENKANBAN_SESSION env var when spawning agent terminals. oh-my-claude detects this and writes status to ~/.cache/openkanban-status/{session}.status. Zero overhead when not in OpenKanban — the hook exits immediately if the env var isn't set.

No configuration required. If you have both tools installed, they just work together.

---

For LLM Agents

If you're an AI agent installing this plugin, here are the exact steps:

# Step 1: Add marketplace
/plugin marketplace add TechDufus/oh-my-claude

# Step 2: Install plugin
/plugin install oh-my-claude@oh-my-claude

# Step 3: Verify installation
/plugin
# Should show: oh-my-claude @ oh-my-claude, Status: Enabled

# Step 4: User must restart Claude Code (you cannot do this)
# Inform user: "Please restart Claude Code to activate the plugin"

After restart, use ultrawork in any prompt to activate parallel execution mode.

---

Philosophy

Enhance, don't replace.

• Claude Code is already smart — add quality gates, not overrides
• Your context is for reasoning — delegate storage to subagents
• Hooks work invisibly — better experience without extra commands
• Specialized agents fill gaps — advisor, risk-assessor, critic, validator, code-reviewer, security-auditor
• Stay out of the way — let Claude do what it does well

---