# oh-my-agent: Portable Multi-Agent Harness [![npm version](https://img.shields.io/npm/v/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![npm downloads](https://img.shields.io/npm/dm/oh-my-agent?color=cb3837&logo=npm)](https://www.npmjs.com/package/oh-my-agent) [![GitHub stars](https://img.shields.io/github/stars/first-fluke/oh-my-agent?style=flat&logo=github)](https://github.com/first-fluke/oh-my-agent) [![License](https://img.shields.io/github/license/first-fluke/oh-my-agent)](https://github.com/first-fluke/oh-my-agent/blob/main/LICENSE) [![Last Updated](https://img.shields.io/github/last-commit/first-fluke/oh-my-agent?label=updated&logo=git)](https://github.com/first-fluke/oh-my-agent/commits/main) [English](../README.md) | [한국어](./README.ko.md) | [中文](./README.zh.md) | [Português](./README.pt.md) | [日本語](./README.ja.md) | [Français](./README.fr.md) | [Español](./README.es.md) | [Nederlands](./README.nl.md) | [Polski](./README.pl.md) | [Русский](./README.ru.md) | [Tiếng Việt](./README.vi.md) | [ภาษาไทย](./README.th.md) Hast du dir schon mal gewünscht, dein KI-Assistent hätte Kollegen? Genau das macht oh-my-agent. Statt dass eine einzige KI alles erledigt (und sich auf halbem Weg verheddert), verteilt oh-my-agent die Arbeit auf **spezialisierte Agenten**: Frontend, Backend, Architektur, QA, PM, DB, Mobile, Infra, Debug, Design und mehr. Jeder kennt sein Fachgebiet in- und auswendig, hat eigene Tools und Checklisten und bleibt in seiner Spur. Funktioniert mit allen großen KI-IDEs: Antigravity, Claude Code, Codex, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code und weiteren. ## Schnellstart ```bash # macOS / Linux — installiert bun, uv & serena automatisch, falls nicht vorhanden curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash ``` ```powershell # Windows (PowerShell) — installiert bun, uv & serena automatisch, falls nicht vorhanden irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex ``` ```bash # Oder manuell (beliebiges OS, benötigt bun + uv + serena) bunx oh-my-agent@latest ``` ### Installation via Agent Package Manager

Microsofts Agent Package Manager (APM): nur Skills. Klick zum Ausklappen.

> Nicht zu verwechseln mit dem APM (Application Performance Monitoring) von `oma-observability`. ```bash # Alle Skills, in jede erkannte Runtime ausgerollt # (.claude, .cursor, .codex, .opencode, .github, .agents) apm install first-fluke/oh-my-agent # Ein einzelnes Skill apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend ``` APM liefert nur die Skills. Für Workflows, Regeln, `oma-config.yaml`, Keyword-Detection-Hooks und das `oma agent:spawn`-CLI nimmst du `bunx oh-my-agent@latest`. Pro Projekt eine Distribution wählen, sonst läuft das auseinander.

Wähl ein Preset und los geht's: | Preset | Was Du Bekommst | |--------|-------------| | ✨ All | Alle Agenten und Skills | | 🌐 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 | ## Funktioniert mit jedem Agent `oh-my-agent` behält `.agents/` als Single Source of Truth (SSOT) und projiziert es in das native Layout jeder Runtime. So teilen sich alle unterstützten Tools dieselben Skills, Workflows und Regeln.

Claude Code _{nativ + Adapter}	Codex CLI _{nativ + Adapter}	Antigravity _{natives SSOT}	Cursor _{nativ + Adapter}	Qwen Code _{natives Dispatch}	Reasonix _{nativ kompatibel}
Pi _{nativ kompatibel}	OpenCode _{nativ kompatibel}	Amp _{nativ kompatibel}	GitHub Copilot _{Skills per Symlink}	Grok Build _{native Hooks}	Kiro CLI _{native Hooks + Agents}

_{& mehr}

## Dein Agenten-Team | Agent | Was Er Macht | |-------|-------------| | **oma-academic-writer** | Entwirft, überarbeitet und prüft akademische Prosa bis zur Publikationsreife | | **oma-architecture** | Wägt Architektur-Trade-offs ab und zieht Modulgrenzen — mit ADR/ATAM/CBAM-Analyse | | **oma-backend** | Baut und sichert deine APIs in Python, Node.js oder Rust | | **oma-brainstorm** | Erkundet Ideen gemeinsam mit dir, bevor du dich für einen Weg entscheidest | | **oma-coordination** | Führt Schritt für Schritt durch die manuelle Koordination von PM-, Frontend-, Backend-, Mobile- und QA-Agenten | | **oma-db** | Entwirft dein Schema, Migrationen, Indizes und Vector Stores | | **oma-debug** | Findet die Ursache, behebt den Bug und schreibt einen Regressionstest | | **oma-deepsec** | Scannt deinen Code auf Sicherheitslücken und blockiert riskante Pull Requests | | **oma-design** | Baut Design-Systeme mit Tokens, Barrierefreiheit und Responsive Layouts | | **oma-dev-workflow** | Automatisiert deine CI/CD, Releases und Monorepo-Aufgaben | | **oma-docs** | Prüft deine Docs auf defekte Referenzen und markiert Stellen, die ein Code-Change berührt hat | | **oma-frontend** | Baut deine UI mit React/Next.js, TypeScript, Tailwind CSS v4 und shadcn/ui | | **oma-hwp** | Konvertiert HWP-, HWPX- und HWPML-Dateien in Markdown | | **oma-image** | Generiert Bilder parallel über mehrere KI-Anbieter | | **oma-market** | Recherchiert deinen Markt aus Community-Signalen und rahmt ihn mit SWOT, Porter's 5F und PESTEL | | **oma-mobile** | Baut plattformübergreifende Mobile-Apps mit Flutter | | **oma-observability** | Routet Observability-Arbeit über Metriken, Logs, Traces, SLOs und Incident-Forensik | | **oma-orchestrator** | Führt mehrere Agenten parallel über die CLI aus | | **oma-pdf** | Konvertiert PDF-Dateien in Markdown | | **oma-pm** | Plant Aufgaben, zerlegt Anforderungen und definiert API-Verträge | | **oma-qa** | Überprüft deinen Code auf OWASP-Sicherheitslücken, Performance- und Barrierefreiheitsprobleme | | **oma-recap** | Fasst deinen Gesprächsverlauf in thematische Arbeitsberichte zusammen | | **oma-refactor** | Refaktoriert Code ohne Verhaltensänderung mit Hotspot-Auswahl, Charakterisierungstests als Sicherheitsnetz und reinen Refactor-Commits | | **oma-scholar** | Durchsucht akademische Literatur und unterstützt dich beim Peer-Review | | **oma-scm** | Verwaltet deine Branches, Merges, Worktrees und Conventional Commits | | **oma-search** | Leitet jede Suchanfrage an die beste Quelle weiter und bewertet, wie vertrauenswürdig das Ergebnis ist | | **oma-skill-creator** | Schreibt und prüft neue OMA-Skills im SSL-lite-Format | | **oma-slide** | Erzeugt markante, animationsreiche HTML-Präsentationsdecks und exportiert nach PDF/PNG/PPTX | | **oma-tf-infra** | Provisioniert Multi-Cloud-Infrastruktur mit Terraform | | **oma-translator** | Übersetzt zwischen Sprachen so, als hätte ein Muttersprachler geschrieben | | **oma-video** | Erzeugt Kurzvideos, Erklärvideos und Demos über eine auch ohne Schlüssel nutzbare Remotion-Pipeline | | **oma-voice** | Generiert Voiceovers und transkribiert Audio lokal — ganz ohne Cloud | ## So Funktioniert's Einfach chatten. Beschreib, was du willst, und oh-my-agent sucht die passenden Agenten aus. ``` Du: "Bau eine TODO-App mit User-Authentifizierung" → PM plant die Arbeit → Backend baut die Auth-API → Frontend baut die React-UI → DB entwirft das Schema → QA prüft alles durch → Fertig: koordinierter, geprüfter Code ``` Oder nutz Slash Commands für strukturierte Workflows: | Schritt | Befehl | Was Er Macht | |---------|--------|-------------| | 0 | `/deepinit` | Erfasst deine bestehende Codebasis in AGENTS.md, ARCHITECTURE.md und docs | | 1 | `/brainstorm` | Erkundet Ideen mit dir, bevor du dich aufs Bauen festlegst | | 2 | `/architecture` | Wägt deine Design-Trade-offs ab und zieht saubere Modulgrenzen | | 2 | `/design` | Baut dein Design-System mit Tokens, Barrierefreiheit und responsiven Layouts | | 2 | `/plan` | Zerlegt dein Feature in priorisierte Aufgaben | | 3 | `/work` | Baut dein Feature Schritt für Schritt über mehrere Agenten hinweg | | 3 | `/orchestrate` | Lässt mehrere Agenten parallel laufen, um dein Feature schneller zu bauen | | 3 | `/ultrawork` | Baut dein Feature durch fünf Qualitätsphasen und elf Review-Gates | | 3 | `/ralph` | Wiederholt `/ultrawork`, bis ein unabhängiger Prüfer jedes Kriterium besteht | | 4 | `/review` | Prüft deinen Code auf Sicherheits-, Performance- und Barrierefreiheits-Probleme | | 4 | `/deepsec` | Führt einen tiefen Security-Scan durch und blockiert riskante Pull Requests | | 5 | `/debug` | Findet die Ursache, behebt den Bug und schreibt einen Regressionstest | | 5 | `/docs` | Prüft deine Docs auf kaputte Verweise und patcht die, die deine Code-Änderungen betreffen | | 6 | `/scm` | Verwaltet deine Branches, Merges und Conventional Commits | | - | `/schedule` | Plant einen Agenten-Job, der in einem wiederkehrenden Intervall läuft | **Auto-Erkennung**: Du brauchst nicht mal Slash Commands. Schlüsselwörter wie "Architektur", "plan", "review" und "debug" in deiner Nachricht (in 11 Sprachen!) aktivieren automatisch den richtigen Workflow. ### Per-Agent-Modelle Jeder Agent kann ein eigenes Modell und `effort` über `.agents/oma-config.yaml` beziehen. Folgende Runtime-Profile sind vorkonfiguriert: `antigravity`, `claude`, `codex`, `cursor`, `kiro`, `mixed`, `qwen`. Prüfe die aufgelöste Auth-Matrix mit `oma doctor --profile`. Vollständige Anleitung: [web/docs/guide/per-agent-models.md](../web/docs/guide/per-agent-models.md). ## Warum oh-my-agent? > [Mehr erfahren →](https://github.com/first-fluke/oh-my-agent/issues/155#issuecomment-4142133589) - **Portabel**: `.agents/` reist mit deinem Projekt, nicht in einer IDE eingesperrt - **Rollenbasiert**: Agenten wie ein echtes Engineering-Team modelliert, kein Haufen Prompts - **Token-effizient**: Zwei-Schichten-Skill-Design spart ~75% der Tokens - **Qualität zuerst**: Charter Preflight, Quality Gates und Review-Workflows eingebaut: - `oma verify ` — 14 deterministische Checks pro Agententyp (TypeScript strict, Tests, raw SQL, hartkodierte Secrets, Flutter analyze, Inline-Styles, Scope-Verletzung, Charter Alignment …) - `session.quota_cap` — Token- / Spawn- / Per-Vendor-Budgets pro Session in `oma-config.yaml`; `orchestrate` Step 5 blockiert den nächsten Spawn bei Überschreitung - `ralph` Workflow — unabhängiger JUDGE verifiziert jedes Criterion in jeder Iteration erneut, um stille Regressionen zu erkennen; Caching für Tests >30s - Exploration Loop — nach 2 Retries spawnt `orchestrate` Hypothesen-Varianten parallel und behält das Ergebnis mit der höchsten Punktzahl - Monorepo-Auto-Routing — `detectWorkspace` liest pnpm / nx / turbo / lerna und routet jeden Agenten zu seinem Workspace - **Multi-Vendor**: mische Antigravity, Claude, Codex, Cursor, Kiro und Qwen je nach Agententyp - **Beobachtbar**: Terminal- und Web-Dashboards für Echtzeit-Monitoring ## Architektur ```mermaid 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]) ``` ## Mehr Erfahren - **[Detaillierte Dokumentation](./AGENTS_SPEC.md)**: vollständige technische Spec und Architektur - **[Unterstützte Agenten](./SUPPORTED_AGENTS.md)**: Agenten-Support-Matrix nach IDE - **[Web-Docs](https://first-fluke.github.io/oh-my-agent/)**: Guides, Tutorials und CLI-Referenz ## Sponsors Dieses Projekt wird dank unserer großzügigen Sponsors gepflegt. > **Gefällt dir das Projekt?** Gib ihm einen Stern! > > ```bash > gh api --method PUT /user/starred/first-fluke/oh-my-agent > ``` > > Probier unser optimiertes Starter-Template: [fullstack-starter](https://github.com/first-fluke/fullstack-starter)

### 🚀 Champion ### 🛸 Booster ### ☕ Contributor [Sponsor werden →](https://github.com/sponsors/first-fluke) Siehe [SPONSORS.md](../SPONSORS.md) für die vollständige Liste der Unterstützer. ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=first-fluke/oh-my-agent&type=date&legend=bottom-right)](https://www.star-history.com/#first-fluke/oh-my-agent&type=date&legend=bottom-right) ## Literatur - 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 ## Lizenz MIT