oh-my-agent: Portable Multi-Agent Harness

한국어 | 中文 | 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, Codex, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code, and more.

Quick Start

# 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

Install via Agent Package Manager

<details> <summary>Microsoft's <a href="https://github.com/microsoft/apm">Agent Package Manager</a> (APM) — skills-only distribution. Click to expand.</summary>

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 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.

</details>

Pick a preset and you're ready:

Works With Every Agent

oh-my-agent keeps .agents/ as the single source of truth and projects it into each runtime's native layout, so every supported tool shares the same skills, workflows, and rules.

<table> <colgroup> <col span="6" style="width:16.67%" /> </colgroup> <tr> <td align="center"> <a href="https://claude.com/product/claude-code"><img src="https://github.com/anthropics.png?size=120" alt="Claude Code" width="48" height="48" /></a><br/> <strong>Claude Code</strong><br/> _{native + adapter} </td> <td align="center"> <a href="https://github.com/openai/codex"><img src="https://github.com/openai.png?size=120" alt="Codex CLI" width="48" height="48" /></a><br/> <strong>Codex CLI</strong><br/> _{native + adapter} </td> <td align="center"> <a href="https://antigravity.google"><img src="./docs/assets/agents/antigravity.png" alt="Antigravity" width="48" height="48" /></a><br/> <strong>Antigravity</strong><br/> _{native SSOT} </td> <td align="center"> <a href="https://cursor.com"><img src="https://github.com/cursor.png?size=120" alt="Cursor" width="48" height="48" /></a><br/> <strong>Cursor</strong><br/> _{native + adapter} </td> <td align="center"> <a href="https://github.com/QwenLM/qwen-code"><img src="https://github.com/QwenLM.png?size=120" alt="Qwen Code" width="48" height="48" /></a><br/> <strong>Qwen Code</strong><br/> _{native dispatch} </td> <td align="center"> <a href="https://github.com/esengine/DeepSeek-Reasonix"><img src="https://github.com/deepseek-ai.png?size=120" alt="Reasonix" width="48" height="48" /></a><br/> <strong>Reasonix</strong><br/> _{native-compatible} </td> </tr> <tr> <td align="center"> <a href="https://pi.dev/"><img src="./docs/assets/agents/pi.svg" alt="Pi" width="48" height="48" /></a><br/> <strong>Pi</strong><br/> _{native-compatible} </td> <td align="center"> <a href="https://github.com/anomalyco/opencode"><img src="./docs/assets/agents/opencode.png" alt="OpenCode" width="48" height="48" /></a><br/> <strong>OpenCode</strong><br/> _{native-compatible} </td> <td align="center"> <a href="https://ampcode.com"><img src="./docs/assets/agents/amp.png" alt="Amp" width="48" height="48" /></a><br/> <strong>Amp</strong><br/> _{native-compatible} </td> <td align="center"> <a href="https://github.com/features/copilot"><img src="https://github.com/github.png?size=120" alt="GitHub Copilot" width="48" height="48" /></a><br/> <strong>GitHub Copilot</strong><br/> _{symlinked skills} </td> <td align="center"> <a href="https://grok.x.ai"><img src="./docs/assets/agents/grok.png" alt="Grok Build" width="48" height="48" /></a><br/> <strong>Grok Build</strong><br/> _{native hooks} </td> <td align="center"> <a href="https://kiro.dev"><img src="./docs/assets/agents/kiro.png" alt="Kiro CLI" width="48" height="48" /></a><br/> <strong>Kiro CLI</strong><br/> _{native hooks + agents} </td> </tr> </table>

<p align="center">_{<a href="./docs/SUPPORTED_AGENTS.md">& more</a>}</p>

Your Agent Team

How It Works

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:

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.

Per-Agent Models

Set model_preset in .agents/oma-config.yaml to choose which AI models each agent uses:

language: en
model_preset: mixed   # antigravity | claude | codex | cursor | kiro | mixed | qwen

# Optional per-agent overrides
agents:
  backend: { model: openai/gpt-5.5, effort: high }

• oma doctor --profile — prints the per-role resolved model matrix
• Full guide: web/docs/guide/per-agent-models.md

Why oh-my-agent?

Read why →

• Portable — .agents/ travels with your project, not trapped in one IDE
• Role-based — Agents modeled like a real engineering team, not a pile of prompts
• Token-efficient — Two-layer skill design saves ~75% of tokens
• Quality-first — Charter preflight, quality gates, and review workflows built in:
• oma verify <agent> — a deterministic check battery per agent type: a shared core (scope violation, charter alignment, hardcoded secrets, TODO scan, declared outputs) plus type-specific checks (TypeScript strict, tests, raw SQL, Flutter analyze, inline styles, …)
• session.quota_cap — per-session token / spawn / per-vendor budget caps in oma-config.yaml; orchestrate Step 5 blocks the next spawn when exceeded
• ralph workflow — independent JUDGE re-verifies every criterion each iteration to catch silent regressions; heavy-test caching for >30s suites
• Exploration Loop — after 2 retries, orchestrate spawns hypothesis variants in parallel and keeps the highest-scoring result
• Monorepo auto-routing — detectWorkspace reads pnpm / nx / turbo / lerna and routes each agent to its workspace
• Multi-vendor — Mix Antigravity, Claude, Codex, Cursor, Kiro, and Qwen per agent type
• Observable — Terminal and web dashboards for real-time monitoring

Architecture

flowchart 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])

Learn More

• [Detailed Documentation](./docs/AGENTS_SPEC.md) — Full technical spec and architecture
• [Supported Agents](./docs/SUPPORTED_AGENTS.md) — Agent support matrix across IDEs
• [Web Docs](https://first-fluke.github.io/oh-my-agent/) — Guides, tutorials, and CLI reference

Sponsors

This project is maintained thanks to our generous sponsors.

Like this project? Give it a star!

>

``bash gh api --method PUT /user/starred/first-fluke/oh-my-agent ``

>

Try our optimized starter template: fullstack-starter

<a href="https://github.com/sponsors/first-fluke"> <img src="https://img.shields.io/badge/Sponsor-♥-ea4aaa?style=for-the-badge" alt="Sponsor" /> </a> <a href="https://buymeacoffee.com/firstfluke"> <img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-☕-FFDD00?style=for-the-badge" alt="Buy Me a Coffee" /> </a>

🚀 Champion

<!-- Champion tier ($100/mo) logos here -->

🛸 Booster

<!-- Booster tier ($30/mo) logos here -->

☕ Contributor

<!-- Contributor tier ($10/mo) names here -->

Become a sponsor →

See SPONSORS.md for a full list of supporters.

Star History

References

• Liang, Q., Wang, H., Liang, Z., & Liu, Y. (2026). From skill text to skill structure: The scheduling-structural-logical representation for agent skills (Version 4) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2604.24026
• Chen, C., Yu, Q., Gu, Y., Huang, Z., Li, H., Liu, H., Liu, S., Liu, J., Peng, D., Wang, J., Yan, Z., Meng, F., Qin, E., Che, C., & Hu, M. (2026). The scaling laws of skills in LLM agent systems (Version 1) [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.16508
• Yang, Y., Gong, Z., Huang, W., Yang, Q., Zhou, Z., Huang, Z., Li, Y., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, Y., Chen, D., Yang, X., & Luo, C. (2026). SkillOpt: Executive strategy for self-evolving agent skills [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23904
• Huang, Z., Xu, J., Yang, Y., Gong, Z., Yang, Q., Tian, M., Wang, X., Lv, C., Gao, X., Dai, Q., Liu, B., Qiu, K., Yang, X., Chen, D., Zheng, X., & Luo, C. (2026). From raw experience to skill consumption: A systematic study of model-generated agent skills [Preprint]. arXiv. https://doi.org/10.48550/arXiv.2605.23899

License

MIT