oh-my-harness

Oh My Harness

Lightweight Claude Code harness. Zero config, instant boost.
Smart defaults, test enforcement, model routing, and multi-agent orchestration — all through native hooks.

한국어 · Get Started · Features · Multi-Agent · Config · Architecture

---

Why Oh My Harness?

Claude Code is powerful out of the box — but it doesn't enforce testing, doesn't warn before rm -rf, and treats every request the same regardless of complexity.

Oh My Harness (OMH) adds a thin layer of smart defaults using Claude Code's native hook system. No heavy plugins, no runtime overhead — just hooks, skills, and CLAUDE.md instructions that make every session safer and more productive.

graph LR
    A[You type a prompt] --> B{OMH Hooks}
    B --> C[Ambiguity? Ask first]
    B --> D[3+ tasks? Plan mode]
    B --> E[rm -rf? Warn]
    B --> F[Code changed? Test reminder]
    B --> G[git commit? Convention check]
    style B fill:#7C3AED,color:#fff

---

Philosophy

Minimal guards, maximum customization.

OMH believes the best harness is one you barely notice. Instead of blocking and enforcing, OMH guides with smart defaults — warnings instead of walls, reminders instead of restrictions.

Where OMH truly shines is helping you build and use project-specific skills. Every codebase is different: your test conventions, review checklists, and lint workflows are unique. OMH auto-scaffolds per-project skills based on your detected stack, then gets out of the way so you can customize them.

• Built-in skills (agent management, setup) stay in the plugin
• Project skills (code-review, test-write, lint-fix) live in .claude/skills/ — your project, your rules
• Run /init-project to scaffold, then customize freely

---

Quick Start

Option A: Claude Code Plugin (recommended)

# 1. Install plugin (user scope by default)
claude plugin install oh-my-harness@oh-my-harness

# 2. Restart Claude Code, then initialize your project config:
/harness-setup

Option B: npm CLI

npm install -g oh-my-harness
cd your-project
oh-my-harness init

Either way, start Claude Code as usual — harness features activate automatically.

---

Updating

When a new version is released, update to get the latest hooks, detection patterns, and features.

Plugin mode

# Pull the latest plugin version
claude plugin update oh-my-harness@oh-my-harness

# Re-initialize to apply updated hooks and dictionary
/harness-setup

npm CLI mode

# Update the global package
npm update -g oh-my-harness

# Re-run init to copy updated hooks into your project
oh-my-harness init

Note: init preserves your existing harness.config.json. Only hooks, commands, and CLAUDE.md instructions are refreshed.

---

Features Overview