oh-my-agent: Portable Multi-Agent Harness

한국어 | 中文 | Português | 日本語 | Français | Español | Nederlands | Polski | Русский | Deutsch

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

Quick Start

# One-liner (auto-installs bun & uv if missing)
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

# Or manual
bunx oh-my-agent

Pick a preset and you're ready:

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 "plan", "review", "debug" in your message (in 11 languages!) auto-activate the right workflow.

CLI

# 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 agent:spawn backend "Build auth API" session-01
oma agent:parallel -i backend:"Auth API" frontend:"Login form"

Why oh-my-agent?

• 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
• Multi-vendor — Mix Gemini, Claude, Codex, 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["/coordinate"]
        W1b["/ultrawork"]
        W2["/orchestrate"]
        W3["/plan"]
        W4["/review"]
        W5["/debug"]
        W6["/deepinit"]
        W7["/design"]
    end

    subgraph Orchestration["Orchestration"]
        direction TB
        PM[oma-pm]
        ORC[oma-orchestrator]
    end

    subgraph Domain["Domain Agents"]
        direction TB
        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 --> CMT([oma-commit])

Learn More

• Detailed Documentation — Full technical spec and architecture
• Supported Agents — Agent support matrix across IDEs
• Web Docs — Guides, tutorials, and CLI reference

Sponsors

This project is maintained thanks to our generous sponsors.

Like this project? Give it a star!

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

Try our optimized starter template: fullstack-starter

🚀 Champion

🛸 Booster

☕ Contributor

Become a sponsor →

See SPONSORS.md for a full list of supporters.

Star History

License

MIT