https://github.com/first-fluke/oh-my-ag
The Ultimate Multi-Agent Harness for Google Antigravity. Orchestrate 6 specialized agents via Serena Memory. Parallel CLI execution, real-time observability, and zero-config skills.
https://github.com/first-fluke/oh-my-ag
agent-harness ai-agents antigravity backend-agent debug-agent frontend-agent harness mobile-agent multi-agent orchestrator pm-agent qa-agent serena
Last synced: 5 months ago
JSON representation
The Ultimate Multi-Agent Harness for Google Antigravity. Orchestrate 6 specialized agents via Serena Memory. Parallel CLI execution, real-time observability, and zero-config skills.
- Host: GitHub
- URL: https://github.com/first-fluke/oh-my-ag
- Owner: first-fluke
- Created: 2026-01-30T11:29:46.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-02T04:54:31.000Z (5 months ago)
- Last Synced: 2026-03-02T06:29:32.039Z (5 months ago)
- Topics: agent-harness, ai-agents, antigravity, backend-agent, debug-agent, frontend-agent, harness, mobile-agent, multi-agent, orchestrator, pm-agent, qa-agent, serena
- Language: TypeScript
- Homepage: https://first-fluke.github.io/oh-my-ag/
- Size: 4.91 MB
- Stars: 273
- Watchers: 1
- Forks: 39
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# oh-my-ag: Multi-Agent Orchestrator for Antigravity
[한국어](./docs/README.ko.md) | [中文](./docs/README.zh.md) | [Português](./docs/README.pt.md) | [日本語](./docs/README.ja.md) | [Français](./docs/README.fr.md) | [Español](./docs/README.es.md) | [Nederlands](./docs/README.nl.md) | [Polski](./docs/README.pl.md) | [Українська](./docs/README.uk.md) | [Русский](./docs/README.ru.md) | [Deutsch](./docs/README.de.md)
The Ultimate Multi-Agent Harness for Google Antigravity and beyond.
Orchestrate 9 specialized domain agents (PM, Frontend, Backend, Mobile, QA, Debug, Brainstorm, DevWorkflow, Terraform) via **Serena Memory**. Features parallel CLI execution, real-time observability dashboards, and zero-config progressive skill loading. The batteries-included solution for agentic coding.
## Table of Contents
- [Architecture](#architecture)
- [What Is This?](#what-is-this)
- [Quick Start](#quick-start)
- [Sponsors](#sponsors)
- [License](#license)
## Architecture
```mermaid
flowchart TD
subgraph Workflows["Workflows"]
direction TB
W1["/coordinate"]
W2["/orchestrate"]
W3["/plan"]
W4["/review"]
W5["/debug"]
end
subgraph Orchestration["Orchestration"]
direction TB
PM[pm-agent]
WF[workflow-guide]
ORC[orchestrator]
end
subgraph Domain["Domain Agents"]
direction TB
FE[frontend-agent]
BE[backend-agent]
MB[mobile-agent]
end
subgraph Quality["Quality"]
direction TB
QA[qa-agent]
DBG[debug-agent]
end
Workflows --> Orchestration
Orchestration --> Domain
Domain --> Quality
Quality --> CMT([commit])
```
## What Is This?
A collection of **Antigravity Skills** enabling collaborative multi-agent development. Work is distributed across expert agents:
| Agent | Specialization | Triggers |
|-------|---------------|----------|
| **Workflow Guide** | Coordinates complex multi-agent projects | "multi-domain", "complex project" |
| **PM Agent** | Requirements analysis, task decomposition, architecture | "plan", "break down", "what should we build" |
| **Frontend Agent** | React/Next.js, TypeScript, Tailwind CSS | "UI", "component", "styling" |
| **Backend Agent** | FastAPI, PostgreSQL, JWT authentication | "API", "database", "authentication" |
| **Mobile Agent** | Flutter cross-platform development | "mobile app", "iOS/Android" |
| **QA Agent** | OWASP Top 10 security, performance, accessibility | "review security", "audit", "check performance" |
| **Debug Agent** | Bug diagnosis, root cause analysis, regression tests | "bug", "error", "crash" |
| **Brainstorm** | Design-first ideation, exploring intent and constraints before planning | "I have an idea", "let's design", "explore approaches" |
| **Developer Workflow** | Monorepo task automation, mise tasks, CI/CD, migrations, release | "dev workflow", "mise tasks", "CI/CD pipeline" |
| **Terraform Infra Engineer** | Multi-cloud IaC provisioning (AWS, GCP, Azure, OCI) | "infrastructure", "terraform", "cloud setup" |
| **Orchestrator** | CLI-based parallel agent execution with Serena Memory | "spawn agent", "parallel execution" |
| **Commit** | Conventional Commits with project-specific rules | "commit", "save changes" |
## Quick Start
### Prerequisites
- **Google Antigravity** (2026+)
- **Bun** (for CLI and dashboards)
- **uv** (for Serena setup)
### Option 1: Interactive CLI (Recommended)
```bash
# Install bun if you don't have it:
# curl -fsSL https://bun.sh/install | bash
# Install uv if you don't have it:
# curl -LsSf https://astral.sh/uv/install.sh | sh
bunx oh-my-ag
```
Select your project type and skills will be installed to `.agent/skills/`.
| Preset | Skills |
|--------|--------|
| ✨ All | Everything |
| 🌐 Fullstack | frontend, backend, pm, qa, debug, commit |
| 🎨 Frontend | frontend, pm, qa, debug, commit |
| ⚙️ Backend | backend, pm, qa, debug, commit |
| 📱 Mobile | mobile, pm, qa, debug, commit |
### Option 2: Global Installation (For Orchestrator)
To use the core tools globally or run the SubAgent Orchestrator:
```bash
bun install --global oh-my-ag
```
You'll also need at least one CLI tool:
| CLI | Install | Auth |
|-----|---------|------|
| Gemini | `bun install --global @google/gemini-cli` | `gemini auth` |
| Claude | `bun install --global @anthropic-ai/claude-code` | `claude auth` |
| Codex | `bun install --global @openai/codex` | `codex auth` |
| Qwen | `bun install --global @qwen-code/qwen` | `qwen auth` |
### Option 3: Integrate into Existing Project
**Recommended (CLI):**
Run the following command in your project root to automatically install/update skills and workflows:
```bash
bunx oh-my-ag
```
> **Tip:** Run `bunx oh-my-ag doctor` after installation to verify everything is set up correctly (including global workflows).
### 2. Chat
**Explicit coordination** (user-triggered workflow):
```
/coordinate
→ Step-by-step: PM planning → agent spawning → QA review
```
**Complex project** (workflow-guide coordinates):
```
"Build a TODO app with user authentication"
→ workflow-guide → PM Agent plans → agents spawned in Agent Manager
```
**Simple task** (single agent auto-activates):
```
"Create a login form with Tailwind CSS and form validation"
→ frontend-agent activates
```
**Commit changes** (conventional commits):
```
/commit
→ Analyze changes, suggest commit type/scope, create commit with Co-Author
```
### 3. Monitor with Dashboards
For dashboard setup and usage details, see [`web/content/en/guide/usage.md`](./web/content/en/guide/usage.md#real-time-dashboards).
## 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-ag
> ```
>
> Try our optimized starter template: [fullstack-starter](https://github.com/first-fluke/fullstack-starter)
### 🚀 Champion
### 🛸 Booster
### ☕ Contributor
[Become a sponsor →](https://github.com/sponsors/first-fluke)
See [SPONSORS.md](./SPONSORS.md) for a full list of supporters.
## Star History
[](https://www.star-history.com/#first-fluke/oh-my-ag&type=date&legend=bottom-right)
## License
MIT