oh-my-agent: The Multi-Agent Harness That Checks the Work

한국어 | 中文 | Português | 日本語 | Français | Español | Nederlands | Polski | Русский | Deutsch | Tiếng Việt | ภาษาไทย

Agents narrate success. oh-my-agent checks the artifacts.

Spawning parallel agents is the easy part. The hard part is knowing whether they actually did the work. "Tests pass, all criteria met" costs an agent nothing to say, and nothing inside that same session can contradict it.

oh-my-agent makes the claim falsifiable. A Stop hook refuses to end your session until your project's own typecheck / test / lint script exits 0. A gate command decides whether a workflow really ran by looking for the artifacts it must have left behind — and its JSON verdict, not the agent's summary, is the result. An independent judge with a fresh context re-verifies every criterion each round, including the ones that already passed. Every gate decision lands on an append-only event log you can read after the fact. Then it runs that same discipline across a dozen agent runtimes from one portable .agents/ directory.

Start with the existing Quick Start to choose an install path, ask a named skill for one scoped change, and record the file, check command, and exit status. The full-harness path includes oma doctor.

Watch the full video (35s)

Quick Start

Fastest path — skills into your agents (Claude Code, Cursor, Codex, and more):

npx skills add first-fluke/oh-my-agent

That installs the OMA skill pack into detected agent runtimes. Skills teach the agent how to work; the full harness (below) is what checks whether the work actually happened — stop-hook gates, artifact verification, independent judges, and an append-only event log.

Full harness (gates, hooks, CLI)

Use this when you want workflows, rules, oma-config.yaml, keyword-detection hooks, and oma agent spawn — not just skills.

The install scripts auto-install bun, uv, and serena if they're missing.

# macOS / Linux — auto-installs bun, uv & serena if missing
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

# Windows (PowerShell) — auto-installs bun, uv & serena if missing
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex

# Or manual (any OS, requires bun + uv + serena)
bunx oh-my-agent@latest

Or install skills with Microsoft's Agent Package Manager (APM). Click to expand.

Not to be confused with oma-observability's APM (Application Performance Monitoring).

# All skills, deployed to every detected runtime
# (.claude, .cursor, .codex, .opencode, .github, .agents)
apm install first-fluke/oh-my-agent

# A single skill
apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend

APM ships skills only. For the full harness, use bunx oh-my-agent@latest (or the scripts above). Prefer one distribution path per project to avoid drift — if you already used npx skills add, stick with skills-only unless you need gates/hooks/CLI.

Pick a preset and you're ready:

Preset	What You Get
All	Every agent and skill
Backend	architecture + backend + brainstorm + db + debug + dev-workflow + pm + qa + scm
Content	academic-writer + design + image + scm + translator + voice
DevOps	architecture + brainstorm + debug + dev-workflow + observability + pm + qa + scm + tf-infra
Frontend	architecture + brainstorm + debug + design + frontend + pm + qa + scm
Fullstack	architecture + backend + brainstorm + db + debug + design + dev-workflow + frontend + mobile + pm + qa + scm + tf-infra
Fullstack Mobile	architecture + backend + brainstorm + db + debug + design + dev-workflow + mobile + pm + qa + scm
Fullstack Web	architecture + backend + brainstorm + db + debug + design + dev-workflow + frontend + pm + qa + scm
Mobile	architecture + brainstorm + debug + mobile + pm + qa + scm
Research	academic-writer + hwp + market + pdf + scholar + scm + search + translator

Agent Integrations

oh-my-agent uses .agents/ as the shared source for agent skills, workflows, rules, and verification gates.

Claude Code native + adapter

Codex CLI native + adapter

Antigravity native SSOT

Cursor native + adapter

Qwen Code native dispatch

DeepSeek Harness Cordis plugin

Pi native-compatible

OpenCode native-compatible

Amp native-compatible

GitHub Copilot symlinked skills

Grok Build native hooks

Kiro CLI native hooks + agents

& more

Your Engineering Team

Instead of one AI doing everything (and getting confused halfway through), oh-my-agent splits work across specialized agents. Each one knows its domain deeply, has its own tools and checklists, and stays in its lane.

Agent	What They Do
oma-architecture	Weighs architecture tradeoffs and draws module boundaries, with ADR/ATAM/CBAM analysis.
oma-backend	Builds and secures your APIs in Python, Node.js, or Rust.
oma-brainstorm	Explores ideas with you before you commit to building.
oma-db	Designs your schema, migrations, indexes, and vector stores.
oma-debug	Finds the root cause, fixes the bug, and writes a regression test.
oma-deepsec	Scans your code for security holes