oh-my-agent: Portable Multi-Agent Harness

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, Cursor, Gemini CLI, Codex CLI, OpenCode i innymi.

Szybki start

# 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

# Windows (PowerShell) — automatycznie zainstaluje bun, uv & serena, jesli brakuje
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex

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

# 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}	Gemini CLI _{natywne + adapter}	Cursor _{natywne + adapter}	Qwen Code _{natywny dispatch}	Grok _{native hooks + agents}
Antigravity _{natywny SSOT}	OpenCode _{natywnie zgodne}	Amp _{natywnie zgodne}	GitHub Copilot _{skills przez symlink}	& wiecej _{macierz wsparcia →}

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-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-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-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
1	`/brainstorm`	Swobodna burza mozgow
2	`/architecture`	Przeglad architektury, trade-offy, analiza w stylu ADR/ATAM/CBAM
2	`/design`	7-fazowy workflow design systemu
2	`/plan`	PM rozbija Twoja funkcjonalnosc na zadania
3	`/work`	Krokowe wykonanie wieloagentowe
3	`/orchestrate`	Automatyczne rownolegle uruchamianie agentow
3	`/ultrawork`	5-fazowy workflow jakosci z 11 bramkami rewizji
4	`/review`	Audyt bezpieczenstwa + wydajnosci + dostepnosci
4	`/deepsec`	Gleboki skan bezpieczenstwa przez agenta
5	`/debug`	Ustrukturyzowane debugowanie z analiza przyczyn
5	`/docs`	Weryfikacja i synchronizacja dryfu dokumentacji przez `oma-docs`
6	`/scm`	Workflow SCM i Git oraz wsparcie Conventional Commits

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.

CLI

# Zainstaluj globalnie
bun install --global oh-my-agent   # lub: brew install oh-my-agent

# Uzywaj gdziekolwiek
oma agent:parallel -i backend:"Auth API" frontend:"Login form"
oma agent:spawn backend "Build auth API" session-01
oma dashboard               # Monitoring w czasie rzeczywistym
oma doctor                  # Sprawdzenie stanu
oma image generate "cat"    # Generowanie obrazów AI od wielu dostawców
oma link                    # Regeneruj .claude/.codex/.gemini/itd. z .agents/
oma model:check             # Wykrywanie rozbieżności między zarejestrowanymi modelami a aktualnymi listami dostawców
oma recap --window 1d       # Podsumowanie historii rozmów między narzędziami
oma retro 7d --compare      # Retrospekcja inżynierska z metrykami + trendami
oma search fetch <url>      # Wyszukiwanie mechaniczne z automatyczną eskalacją strategii

Wybor modelu przebiega w dwoch warstwach:

Natywny dispatch tego samego dostawcy uzywa wygenerowanej definicji agenta dostawcy w .claude/agents/, .codex/agents/ lub .gemini/agents/.
Dispatch miedzy dostawcami lub awaryjny CLI uzywa domyslnych wartosci dostawcy w .agents/skills/oma-orchestrator/config/cli-config.yaml.

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, grok, mixed, qwen. Sprawdz rozwiazana macierz auth komenda oma doctor --profile. Pelny przewodnik: web/docs/guide/per-agent-models.md.

Dlaczego oh-my-agent?

Czytaj więcej →

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 <agent> — 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 Claude, Codex, Cursor i Qwen dla roznych typow agentow
Obserwowalny: dashboardy w terminalu i w przegladarce do monitoringu w czasie rzeczywistym

Architektura

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: pelna specyfikacja techniczna i architektura
Wspierani agenci: macierz wsparcia agentow w roznych IDE
Dokumentacja webowa: poradniki, tutoriale i referencja CLI

Sponsorzy

Ten projekt jest utrzymywany dzieki naszym hojnym sponsorom.

Podoba Ci sie projekt? Daj gwiazdke!
gh api --method PUT /user/starred/first-fluke/oh-my-agent
Wyprobuj nasz zoptymalizowany szablon startowy: fullstack-starter

🚀 Champion

🛸 Booster

☕ Contributor

Zostan sponsorem →

Zobacz SPONSORS.md, aby zobaczyc pelna liste wspierajacych.

Star History

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 2) [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

Licencja

MIT

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

oh-my-agent: Portable Multi-Agent Harness

Szybki start

Instalacja przez Agent Package Manager

Dziala z kazdym agentem

Twoj zespol agentow

Jak to dziala

CLI

Dlaczego oh-my-agent?

Architektura

Dowiedz sie wiecej

Sponsorzy

🚀 Champion

🛸 Booster

☕ Contributor

Star History

Bibliografia

Licencja

Uh oh!

FilesExpand file tree

README.pl.md

Latest commit

History

README.pl.md

File metadata and controls

oh-my-agent: Portable Multi-Agent Harness

Szybki start

Instalacja przez Agent Package Manager

Dziala z kazdym agentem

Twoj zespol agentow

Jak to dziala

CLI

Dlaczego oh-my-agent?

Architektura

Dowiedz sie wiecej

Sponsorzy

🚀 Champion

🛸 Booster

☕ Contributor

Star History

Bibliografia

Licencja