# 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) | [Русский](./README.ru.md) | [Deutsch](./README.de.md) | [Tiếng Việt](./README.vi.md) | [ภาษาไทย](./README.th.md) Chcialbys, zeby Twoj asystent AI mial wspolpracownikow? Wlasnie to robi oh-my-agent. Zamiast jednego AI, ktory robi wszystko (i gubi sie w polowie), oh-my-agent rozdziela prace miedzy **wyspecjalizowanych agentow**: frontend, backend, architecture, QA, PM, DB, mobile, infra, debug, design i innych. Kazdy doskonale zna swoja dziedzine, ma wlasne narzedzia i checklisty, i nie wychodzi poza swoj zakres. Dziala ze wszystkimi glownymi AI IDE: Antigravity, Claude Code, Codex, Cursor, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code i innymi. ## Szybki start ```bash # macOS / Linux — automatycznie zainstaluje bun, uv & serena, jesli brakuje curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash ``` ```powershell # Windows (PowerShell) — automatycznie zainstaluje bun, uv & serena, jesli brakuje irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex ``` ```bash # Lub recznie (dowolny system, wymaga bun + uv + serena) bunx oh-my-agent@latest ``` ### Instalacja przez Agent Package Manager

Agent Package Manager (APM) od Microsoftu: dystrybucja tylko ze skillami. Kliknij, zeby rozwinac.

> Nie myl tego z APM (Application Performance Monitoring) z `oma-observability`. ```bash # Wszystkie skille, wdrazane do kazdego wykrytego runtime # (.claude, .cursor, .codex, .opencode, .github, .agents) apm install first-fluke/oh-my-agent # Pojedynczy skill apm install first-fluke/oh-my-agent/.agents/skills/oma-frontend ``` APM dostarcza tylko skille. Do workflowow, regul, `oma-config.yaml`, hookow detekcji slow kluczowych i CLI `oma agent:spawn` uzyj `bunx oh-my-agent@latest`. W jednym projekcie trzymaj sie jednej dystrybucji, zeby nic sie nie rozjechalo.

Wybierz preset i gotowe: | Preset | Co dostajesz | |--------|-------------| | ✨ All | Wszyscy agenci i umiejetnosci | | 🌐 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 | ## Dziala z kazdym agentem `oh-my-agent` utrzymuje `.agents/` jako jedyne zrodlo prawdy (SSOT) i projektuje je do natywnego ukladu kazdego runtime'u. Dzieki temu wszystkie obslugiwane narzedzia korzystaja z tych samych skills, workflows i regul.

Claude Code _{natywne + adapter}	Codex CLI _{natywne + adapter}	Antigravity _{natywny SSOT}	Cursor _{natywne + adapter}	Qwen Code _{natywny dispatch}	Reasonix _{natywnie zgodne}
Pi _{natywnie zgodne}	OpenCode _{natywnie zgodne}	Amp _{natywnie zgodne}	GitHub Copilot _{skills przez symlink}	Grok Build _{natywne hooki}	Kiro CLI _{natywne hooki + agenci}

_{& wiecej}

## Twoj zespol agentow | Agent | Co robi | |-------|-------------| | **oma-academic-writer** | Pisze, redaguje i audytuje akademicką prozę do jakości publikacyjnej | | **oma-architecture** | Waży kompromisy architektoniczne i wyznacza granice modułów z analizą ADR/ATAM/CBAM | | **oma-backend** | Buduje i zabezpiecza Twoje API w Python, Node.js lub Rust | | **oma-brainstorm** | Eksploruje pomysły razem z Tobą, zanim cokolwiek zaczniesz budować | | **oma-coordination** | Prowadzi krok po kroku ręczną koordynację agentów PM, frontend, backend, mobile i QA | | **oma-db** | Projektuje schematy, migracje, indeksy i vector stores | | **oma-debug** | Znajduje przyczynę błędu, naprawia go i pisze test regresji | | **oma-deepsec** | Skanuje kod w poszukiwaniu luk bezpieczeństwa i blokuje ryzykowne pull requesty | | **oma-design** | Buduje design systemy z tokenami, dostępnością i responsywnymi layoutami | | **oma-dev-workflow** | Automatyzuje CI/CD, releasy i zadania w monorepo | | **oma-docs** | Sprawdza dokumentację pod kątem zepsutych referencji i wskazuje miejsca dotknięte zmianami w kodzie | | **oma-frontend** | Buduje interfejs użytkownika z React/Next.js, TypeScript, Tailwind CSS v4 i shadcn/ui | | **oma-hwp** | Konwertuje pliki HWP, HWPX i HWPML do Markdown | | **oma-image** | Generuje obrazy równolegle przez kilku dostawców AI | | **oma-market** | Bada rynek na podstawie sygnałów społecznościowych i opisuje wyniki przez SWOT, Porter's 5F i PESTEL | | **oma-mobile** | Buduje wieloplatformowe aplikacje mobilne we Flutter | | **oma-observability** | Kieruje pracę obserwabilności przez metryki, logi, traces, SLO i analizę incydentów | | **oma-orchestrator** | Uruchamia wiele agentów równolegle z poziomu CLI | | **oma-pdf** | Konwertuje pliki PDF do Markdown | | **oma-pm** | Planuje zadania, rozbija wymagania i definiuje kontrakty API | | **oma-qa** | Przegląda kod pod kątem bezpieczeństwa OWASP, wydajności i dostępności | | **oma-recap** | Podsumowuje historię rozmów w tematyczne raporty z pracy | | **oma-refactor** | Refaktoryzuje kod bez zmiany zachowania, wykorzystując hotspoty, testy charakteryzujące i commity zawierające wyłącznie refactor | | **oma-scholar** | Przeszukuje literaturę akademicką i pomaga przeprowadzić recenzję naukową | | **oma-scm** | Zarządza branchami, mergami, worktrees i Conventional Commits | | **oma-search** | Kieruje każde zapytanie do najlepszego źródła i ocenia wiarygodność wyniku | | **oma-skill-creator** | Pisze i audytuje nowe skille OMA w formacie SSL-lite | | **oma-slide** | Generuje charakterystyczne, bogate w animacje decki prezentacji HTML i eksportuje do PDF/PNG/PPTX | | **oma-tf-infra** | Provisionuje wielochmurową infrastrukturę za pomocą Terraform | | **oma-translator** | Tłumaczy między językami tak, jakby tekst napisał native speaker | | **oma-video** | Generuje krótkie filmy, materiały objaśniające i dema przez pipeline Remotion działający także bez kluczy | | **oma-voice** | Generuje voiceover i transkrybuje audio lokalnie — bez chmury | ## Jak to dziala Po prostu pisz. Opisz, czego potrzebujesz, a oh-my-agent sam ustali, ktorych agentow uzyc. ``` Ty: "Zbuduj aplikacje TODO z uwierzytelnianiem uzytkownikow" → PM planuje prace → Backend buduje API uwierzytelniania → Frontend buduje UI w React → DB projektuje schemat → QA przeglada wszystko → Gotowe: skoordynowany, sprawdzony kod ``` Lub uzyj slash commands do ustrukturyzowanych workflow: | Krok | Komenda | Co robi | |------|---------|-------------| | 0 | `/deepinit` | Mapuje Twoja istniejaca baze kodu do AGENTS.md, ARCHITECTURE.md i docs | | 1 | `/brainstorm` | Przeglada z Toba pomysly, zanim zabierzesz sie za budowanie | | 2 | `/architecture` | Wazy trade-offy Twojego projektu i wyznacza czyste granice modulow | | 2 | `/design` | Buduje Twoj design system z tokenami, dostepnoscia i responsywnymi ukladami | | 2 | `/plan` | Rozbija Twoja funkcjonalnosc na zadania z priorytetami | | 3 | `/work` | Buduje Twoja funkcjonalnosc krok po kroku, korzystajac z wielu agentow | | 3 | `/orchestrate` | Uruchamia wielu agentow rownolegle, by szybciej zbudowac Twoja funkcjonalnosc | | 3 | `/ultrawork` | Buduje Twoja funkcjonalnosc przez piec faz jakosci i jedenascie bramek rewizji | | 3 | `/ralph` | Powtarza `/ultrawork` az niezalezny weryfikator zaliczy wszystkie kryteria | | 4 | `/review` | Przeglada Twoj kod pod katem bezpieczenstwa, wydajnosci i dostepnosci | | 4 | `/deepsec` | Wykonuje gleboki skan bezpieczenstwa i blokuje ryzykowne pull requesty | | 5 | `/debug` | Znajduje przyczyne, naprawia blad i pisze test regresji | | 5 | `/docs` | Sprawdza Twoja dokumentacje pod katem zepsutych odwolan i lata te, ktorych dotykaja zmiany w kodzie | | 6 | `/scm` | Zarzadza Twoimi galeziami, scaleniami i Conventional Commits | | - | `/schedule` | Planuje zadanie agenta do cyklicznego uruchamiania w zadanym interwale | **Autodetekcja**: Nie musisz nawet uzywac slash commands. Slowa takie jak "architektura", "plan", "review" i "debug" w Twojej wiadomosci (w 11 jezykach!) automatycznie uruchamiaja odpowiedni workflow. ### Modele per agent Kazdy agent moze miec wlasny model i `effort` zdefiniowany w `.agents/oma-config.yaml`. Dostepne gotowe runtime profiles: `antigravity`, `claude`, `codex`, `cursor`, `kiro`, `mixed`, `qwen`. Sprawdz rozwiazana macierz auth komenda `oma doctor --profile`. Pelny przewodnik: [web/docs/guide/per-agent-models.md](../web/docs/guide/per-agent-models.md). ## Dlaczego oh-my-agent? > [Czytaj więcej →](https://github.com/first-fluke/oh-my-agent/issues/155#issuecomment-4142133589) - **Przenosny**: `.agents/` wedruje z Twoim projektem, nie jest uwieziony w jednym IDE - **Oparty na rolach**: agenci zamodelowani jak prawdziwy zespol inzynierski, nie sterta promptow - **Oszczedny z tokenami**: dwuwarstwowy design umiejetnosci oszczedza ~75% tokenow - **Jakosc przede wszystkim**: Charter preflight, quality gates i workflow rewizji wbudowane: - `oma verify ` — 14 deterministycznych sprawdzen na typ agenta (TypeScript strict, testy, raw SQL, twardo zakodowane sekrety, Flutter analyze, inline styles, scope violation, charter alignment …) - `session.quota_cap` — limity tokenow / spawn / per-vendor na sesje w `oma-config.yaml`; `orchestrate` Step 5 blokuje kolejny spawn po przekroczeniu - workflow `ralph` — niezalezny JUDGE re-weryfikuje kazde criterion w kazdej iteracji aby wychwycic ciche regresje; cache dla testow >30s - Exploration Loop — po 2 retry `orchestrate` spawnuje warianty hipotez rownolegle i zachowuje wynik o najwyzszej punktacji - Auto-routing monorepo — `detectWorkspace` czyta pnpm / nx / turbo / lerna i kieruje kazdego agenta do jego workspace - **Multi-vendor**: mieszaj Antigravity, Claude, Codex, Cursor, Kiro i Qwen dla roznych typow agentow - **Obserwowalny**: dashboardy w terminalu i w przegladarce do monitoringu w czasie rzeczywistym ## Architektura ```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]) ``` ## Dowiedz sie wiecej - **[Szczegolowa dokumentacja](./AGENTS_SPEC.md)**: pelna specyfikacja techniczna i architektura - **[Wspierani agenci](./SUPPORTED_AGENTS.md)**: macierz wsparcia agentow w roznych IDE - **[Dokumentacja webowa](https://first-fluke.github.io/oh-my-agent/)**: poradniki, tutoriale i referencja CLI ## Sponsorzy Ten projekt jest utrzymywany dzieki naszym hojnym sponsorom. > **Podoba Ci sie projekt?** Daj gwiazdke! > > ```bash > gh api --method PUT /user/starred/first-fluke/oh-my-agent > ``` > > Wyprobuj nasz zoptymalizowany szablon startowy: [fullstack-starter](https://github.com/first-fluke/fullstack-starter)

### 🚀 Champion ### 🛸 Booster ### ☕ Contributor [Zostan sponsorem →](https://github.com/sponsors/first-fluke) Zobacz [SPONSORS.md](../SPONSORS.md), aby zobaczyc pelna liste wspierajacych. ## 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) ## Bibliografia - 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 ## Licencja MIT