by first-fluke
Portable multi-agent harness for .agents-based skills, workflows, and standards-aware agent teams across Antigravity, Claude Code, Codex, Cursor, OpenCode, and more.
# Add to your Claude Code skills
git clone https://github.com/first-fluke/oh-my-agent한국어 | 中文 | Português | 日本語 | Français | Español | Nederlands | Polski | Русский | Deutsch | Tiếng Việt | ภาษาไทย
Ever wished your AI assistant had coworkers? That's what oh-my-agent does.
Instead of one AI doing everything (and getting confused halfway through), oh-my-agent splits work across specialized agents — frontend, backend, architecture, QA, PM, DB, mobile, infra, debug, design, and more. Each one knows its domain deeply, has its own tools and checklists, and stays in its lane.
Works with all major AI IDEs: Antigravity, Claude Code, Cursor, Gemini CLI, Codex CLI, OpenCode, and more.
Vendor-native subagents are generated from :
No comments yet. Be the first to share your thoughts!
.agents/agents/.claude/agents/*.md.codex/agents/*.toml.gemini/agents/*.mdWhen a workflow resolves an agent to the same vendor as the current runtime, it should use that vendor's native subagent path first. Cross-vendor tasks fall back to oma agent:spawn.
# macOS / Linux — auto-installs bun & uv if missing
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash
# Windows (PowerShell) — auto-installs bun & uv if missing
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex
# Or manual (any OS, requires bun + uv)
bunx oh-my-agent@latest
Microsoft's Agent Package Manager (APM) — not to be confused with
oma-observability's APM (Application Performance Monitoring).
# 22 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 reads .claude-plugin/plugin.json's skills: .agents/skills/ pointer, so the .agents/ SSOT is the only source — no build step or mirror.
APM ships the 22 skills only. For workflows, rules, oma-config.yaml, keyword-detection hooks, and the oma agent:spawn CLI, use bunx oh-my-agent@latest. Pick one distribution per project to avoid drift.
Pick a preset and you're ready:
| Preset | What You Get | |--------|-------------| | ✨ All | Every agent and skill | | 🌐 Fullstack | architecture + frontend + backend + db + pm + qa + debug + brainstorm + scm | | 🎨 Frontend | architecture + frontend + pm + qa + debug + brainstorm + scm | | ⚙️ Backend | architecture + backend + db + pm + qa + debug + brainstorm + scm | | 📱 Mobile | architecture + mobile + pm + qa + debug + brainstorm + scm | | 🚀 DevOps | architecture + tf-infra + dev-workflow + pm + qa + debug + brainstorm + scm |
| Agent | What They Do | |-------|-------------| | oma-architecture | Architectural tradeoffs, boundaries, ADR/ATAM/CBAM-aware analysis | | oma-backend | APIs in Python, Node.js, or Rust | | oma-brainstorm | Explores ideas before you commit to building | | oma-coordination | Manual step-by-step multi-agent coordination guide | | oma-db | Schema design, migrations, indexing, vector DB | | oma-debug | Root cause analysis, fixes, regression tests | | oma-design | Design systems, tokens, accessibility, responsive | | oma-dev-workflow | CI/CD, releases, monorepo automation | | oma-frontend | React/Next.js, TypeScript, Tailwind CSS v4, shadcn/ui | | oma-hwp | HWP/HWPX/HWPML to Markdown conversion | | oma-image | Multi-vendor AI image generation | | oma-mobile | Flutter cross-platform apps | | oma-observability | Observability router — APM/RUM, metrics/logs/traces/profiles, SLO, incident forensics, transport tuning | | oma-orchestrator | Parallel agent execution via CLI | | oma-pdf | PDF to Markdown conversion | | oma-pm | Plans tasks, breaks down requirements, defines API contracts | | oma-qa | OWASP security, performance, accessibility review | | oma-recap | Conversation history recap and themed work summaries | | oma-scm | SCM (software configuration management) — branching, merges, worktrees, baselines; Conventional Commits | | oma-search | Intent-based search router with trust scoring — docs, web, code, local | | oma-tf-infra | Multi-cloud Terraform IaC (Infrastructure as Code) | | oma-translator | Natural multilingual translation |
Just chat. Describe what you want and oh-my-agent figures out which agents to use.
You: "Build a TODO app with user authentication"
→ PM plans the work
→ Backend builds auth API
→ Frontend builds React UI
→ DB designs schema
→ QA reviews everything
→ Done: coordinated, reviewed code
Or use slash commands for structured workflows:
| Step | Command | What It Does |
|------|---------|-------------|
| 0 | /deepinit | Bootstrap an existing codebase (AGENTS.md, ARCHITECTURE.md, docs/) |
| 1 | /brainstorm | Free-form ideation |
| 2 | /architecture | Software architecture review, tradeoffs, ADR/ATAM/CBAM-style analysis |
| 2 | /design | 7-phase design system workflow |
| 2 | /plan | PM breaks down your feature into tasks |
| 3 | /work | Step-by-step multi-agent execution |
| 3 | /orchestrate | Automated parallel agent spawning |
| 3 | /ultrawork | 5-phase quality workflow with 11 review gates |
| 3 | /ralph | Wraps /ultrawork in an independent verifier loop until criteria pass |
| 4 | /review | Security + performance + accessibility audit |
| 5 | /debug | Structured root-cause debugging |
| 6 | /scm | SCM + Git workflow and Conventional Commit support |
Auto-detection: You don't even need slash commands — keywords like "architecture", "plan", "review", and "debug" in your message (in 11 languages!) auto-activate the right workflow.
# Install globally
bun install --global oh-my-agent # or: brew install oh-my-agent
# Use anywhere
oma doctor # Health check
oma dashboard # Real-time agent monitoring
oma link # Regenerate .claude/.codex/.gemini/etc. from .agents/
oma agent:spawn backend "Build auth API" session-01
oma agent:parallel -i backend:"Auth API" frontend:"Login form"
oma retro 7d --compare # Engineering retrospective with metrics + trends
oma recap --window 1d # Cross-tool conversation history recap
oma search fetch <url> # Mechanical search with auto-escalating strategies
oma image generate "cat" # Multi-vendor AI image generation
oma export cursor # Project skills as `.cursor/rules` for external IDEs
Model selection follows two layers:
.claude/agents/, .codex/agents/, or .gemini/agents/..agents/skills/oma-orchestrator/config/cli-config.yaml.Set model_preset in .agents/oma-config.yaml to choose which AI models each agent uses:
language: en
model_preset: antigravity # claude-only | codex-only | gemini-only | qwen-only | antigravity
# Optional per-agent overrides
agents:
backend: { model: openai/gpt-5.3-codex, effort: high }
oma doctor --profile — prints the per-role resolved model matrixweb/docs/guide/per-agent-models.md.agents/ travels with your project, not trapped in one IDEflowchart TD
subgraph Workflows["Workflows"]
direction TB
W0["/brainstorm"]
W1["/work"]
W1b["/ultrawork"]
W2["/orchestrate"]
W3["/architecture"]
W4["/plan"]
W5["/review"]
W6["/debug"]
W7["/deepinit"]
W8["/design"]
end
subgraph Orchestration["Orchestration"]
direction TB
PM[oma-pm]
ORC[oma-orchestrator]
end
subgraph Domain["Domain Agents"]
direction TB
ARC[oma-architecture]
FE[oma-frontend]
BE[oma-backend]
DB[oma-db]
MB[oma-mobile]
DES[oma-design]
TF[oma-tf-infra]
end
subgraph Quality["Quality"]
direction TB
QA[oma-qa]
DBG[oma-debug]
end
Workflows --> Orchestration
Orchestration --> Domain
Domain --> Quality
Quality --> SCM([oma-scm])