Instalacja

Wymagania wstępne

IDE lub CLI zasilane AI — co najmniej jedno z: Claude Code, Gemini CLI, Codex CLI, Qwen CLI, Antigravity IDE, Cursor lub OpenCode
bun — środowisko uruchomieniowe JavaScript i menedżer pakietów (automatycznie instalowany przez skrypt, jeśli brak)
uv — menedżer pakietów Python dla Serena MCP (automatycznie instalowany, jeśli brak)

Metoda 1: Instalacja jednolinijkowa (zalecana)

curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash

Ten skrypt:

Wykrywa platformę (macOS, Linux)
Sprawdza obecność bun i uv, instalując je jeśli brak
Uruchamia interaktywny instalator z wyborem presetu
Tworzy .agents/ z wybranymi umiejętnościami
Konfiguruje warstwę integracji .claude/ (hooki, dowiązania symboliczne, ustawienia)
Konfiguruje Serena MCP jeśli wykryty

Typowy czas instalacji: poniżej 60 sekund.

Metoda 2: Ręczna instalacja przez bunx

bunx oh-my-agent@latest

Uruchamia interaktywny instalator bez bootstrapu zależności. Wymaga wcześniej zainstalowanego bun.

Instalator prosi o wybranie presetu, który określa, jakie umiejętności zostaną zainstalowane:

Presety

Preset	Zawarte umiejętności
all	oma-brainstorm, oma-pm, oma-frontend, oma-backend, oma-db, oma-mobile, oma-design, oma-qa, oma-debug, oma-tf-infra, oma-dev-workflow, oma-translator, oma-orchestrator, oma-scm, oma-coordination
fullstack	oma-frontend, oma-backend, oma-db, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
frontend	oma-frontend, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
backend	oma-backend, oma-db, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
mobile	oma-mobile, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm
devops	oma-tf-infra, oma-dev-workflow, oma-pm, oma-qa, oma-debug, oma-brainstorm, oma-scm

Każdy preset zawiera oma-pm (planowanie), oma-qa (przegląd), oma-debug (naprawa błędów), oma-brainstorm (ideacja) i oma-scm (git) jako bazowych agentów. Presety domenowe dodają odpowiednich agentów implementacyjnych.

Zasoby współdzielone (_shared/) są zawsze instalowane niezależnie od presetu. Obejmują one podstawowy routing, ładowanie kontekstu, strukturę promptów, wykrywanie dostawcy, protokoły wykonawcze i protokół pamięci.

Co zostaje utworzone

Po instalacji projekt będzie zawierał:

.agents/
├── config/
│   └── oma-config.yaml      # Preferencje
├── skills/
│   ├── _shared/                    # Zasoby współdzielone (zawsze instalowane)
│   │   ├── core/                   # skill-routing, context-loading, itd.
│   │   ├── runtime/                # memory-protocol, execution-protocols/
│   │   └── conditional/            # quality-score, experiment-ledger, itd.
│   ├── oma-frontend/               # Według presetu
│   │   ├── SKILL.md
│   │   └── resources/
│   └── ...                         # Inne wybrane umiejętności
├── workflows/                      # Wszystkie 16 definicji workflow
├── agents/                         # Definicje subagentów
├── mcp.json                        # Konfiguracja serwera MCP
├── results/plan-{sessionId}.json                       # Pusty (wypełniany przez /plan)
├── state/                          # Pusty (używany przez trwałe workflow)
└── results/                        # Pusty (wypełniany przez uruchomienia agentów)

.claude/
├── settings.json                   # Hooki i uprawnienia
├── hooks/
│   ├── triggers.json               # Mapowanie słów kluczowych na workflow (11 języków)
│   ├── keyword-detector.ts         # Logika automatycznego wykrywania
│   ├── persistent-mode.ts          # Wymuszanie trwałych workflow
│   └── hud.ts                      # Wskaźnik [OMA] w pasku stanu
├── skills/                         # Dowiązania symboliczne → .agents/skills/
└── agents/                         # Definicje subagentów dla IDE

.serena/
└── memories/                       # Stan runtime (wypełniany podczas sesji)

Metoda 3: Instalacja globalna

Dla użycia na poziomie CLI (panele kontrolne, uruchamianie agentów, diagnostyka), zainstaluj oh-my-agent globalnie:

Homebrew (macOS/Linux)

brew install oh-my-agent

npm / bun global

bun install --global oh-my-agent
# lub
npm install --global oh-my-agent

To instaluje polecenie oma globalnie, dając dostęp do wszystkich poleceń CLI z dowolnego katalogu:

oma doctor              # Kontrola zdrowia
oma dashboard           # Monitoring w terminalu
oma dashboard:web       # Panel webowy pod http://localhost:9847
oma agent:spawn         # Uruchamianie agentów z terminala
oma agent:parallel      # Równoległe wykonywanie agentów
oma agent:status        # Sprawdzanie stanu agenta
oma stats               # Statystyki sesji
oma retro               # Analiza retrospektywna
oma cleanup             # Czyszczenie artefaktów sesji
oma update              # Aktualizacja oh-my-agent
oma verify              # Weryfikacja wyjścia agenta
oma visualize           # Wizualizacja zależności
oma describe            # Opis struktury projektu
oma bridge              # Most SSE-to-stdio dla Antigravity
oma memory:init         # Inicjalizacja dostawcy pamięci
oma auth:status         # Sprawdzanie stanu uwierzytelniania CLI
oma star                # Dodanie gwiazdki do repozytorium

oma to skrót od oh-my-agent. Oba polecenia działają jako komendy CLI.

Instalacja narzędzi AI CLI

Potrzebujesz co najmniej jednego zainstalowanego narzędzia AI CLI. oh-my-agent obsługuje czterech dostawców i możesz je mieszać — używając różnych CLI dla różnych agentów poprzez mapowanie agent-CLI.

Gemini CLI

bun install --global @google/gemini-cli
# lub
npm install --global @google/gemini-cli

Uwierzytelnianie jest automatyczne przy pierwszym uruchomieniu. Gemini CLI domyślnie czyta umiejętności z .agents/skills/.

Claude Code

curl -fsSL https://claude.ai/install.sh | bash
# lub
npm install --global @anthropic-ai/claude-code

Uwierzytelnianie jest automatyczne przy pierwszym uruchomieniu. Claude Code używa .claude/ dla hooków i ustawień, z umiejętnościami dowiązanymi symbolicznie z .agents/skills/.

Codex CLI

bun install --global @openai/codex
# lub
npm install --global @openai/codex

Po instalacji uruchom codex login aby się uwierzytelnić.

Qwen CLI

bun install --global @qwen-code/qwen-code

Po instalacji uruchom /auth wewnątrz CLI aby się uwierzytelnić.

oma-config.yaml

Polecenie oma install tworzy plik .agents/oma-config.yaml. To centralny plik konfiguracyjny dla całego zachowania oh-my-agent:

# Język odpowiedzi dla wszystkich agentów i workflow
language: en

# Format daty używany w raportach i plikach pamięci
date_format: "YYYY-MM-DD"

# Strefa czasowa dla znaczników czasu
timezone: "UTC"

# Domyślne narzędzie CLI do uruchamiania agentów
# Opcje: gemini, claude, codex, qwen
default_cli: gemini

# Mapowanie CLI per agent (nadpisuje default_cli)
model_preset (per-agent overrides via `agents:`):
  frontend: claude       # Złożone wnioskowanie UI
  backend: gemini        # Szybkie generowanie API
  mobile: gemini
  db: gemini
  pm: gemini             # Szybki rozkład zadań
  qa: claude             # Dokładny przegląd bezpieczeństwa
  debug: claude          # Głęboka analiza przyczyn źródłowych
  design: claude
  tf-infra: gemini
  dev-workflow: gemini
  translator: claude
  orchestrator: gemini
  commit: gemini

Referencja pól

Pole	Typ	Domyślna	Opis
`language`	string	`en`	Kod języka odpowiedzi. Wszystkie wyjścia agentów, komunikaty workflow i raporty używają tego języka. Obsługuje 11 języków (en, ko, ja, zh, es, fr, de, pt, ru, nl, pl).
`date_format`	string	`YYYY-MM-DD`	Format daty dla znaczników czasu w planach, plikach pamięci i raportach.
`timezone`	string	`UTC`	Strefa czasowa dla wszystkich znaczników czasu. Używa standardowych identyfikatorów stref (np. `Asia/Seoul`, `America/New_York`).
`default_cli`	string	`gemini`	Awaryjne CLI gdy nie istnieje mapowanie specyficzne dla agenta. Używane jako poziom 3 w priorytecie rozwiązywania dostawcy.
`model_preset (per-agent overrides via` agents:`)`	map	(pusty)	Mapuje identyfikatory agentów na konkretnych dostawców CLI. Ma pierwszeństwo przed `default_cli`.

Priorytet rozwiązywania dostawcy

Przy uruchamianiu agenta, dostawca CLI jest określany według tego priorytetu (od najwyższego):

Flaga --model przekazana do oma agent:spawn
Wpis model_preset (per-agent overrides via agents:) dla konkretnego agenta w oma-config.yaml
Ustawienie default_cli w oma-config.yaml
active_vendor w cli-config.yaml (awaryjne zachowanie wsteczne)
gemini (zakodowany na stałe ostateczny fallback)

Weryfikacja: `oma doctor`

Po instalacji i konfiguracji zweryfikuj, czy wszystko działa:

oma doctor

To polecenie sprawdza:

Czy wszystkie wymagane narzędzia CLI są zainstalowane i dostępne
Czy konfiguracja serwera MCP jest poprawna
Czy pliki umiejętności istnieją z poprawnym frontmatterem SKILL.md
Czy dowiązania symboliczne w .claude/skills/ wskazują na poprawne cele
Czy hooki są prawidłowo skonfigurowane w .claude/settings.json
Czy dostawca pamięci jest osiągalny (Serena MCP)
Czy oma-config.yaml jest poprawnym YAML z wymaganymi polami

Jeśli coś jest nie tak, oma doctor powie dokładnie co naprawić, z gotowymi poleceniami do skopiowania.

Aktualizacja

Aktualizacja CLI

oma update

Aktualizuje globalne CLI oh-my-agent do najnowszej wersji.

Aktualizacja umiejętności projektu

Umiejętności i workflow w projekcie mogą być aktualizowane przez GitHub Action (action/) do automatycznych aktualizacji, lub ręcznie przez ponowne uruchomienie instalatora:

bunx oh-my-agent@latest

Instalator wykrywa istniejące instalacje i oferuje aktualizację z zachowaniem oma-config.yaml i dowolnej niestandardowej konfiguracji.

Co dalej

Otwórz projekt w IDE AI i zacznij używać oh-my-agent. Umiejętności są automatycznie wykrywane. Spróbuj:

"Build a login form with email validation using Tailwind CSS"

Lub użyj polecenia workflow:

/plan authentication feature with JWT and refresh tokens

Zobacz Przewodnik użytkowania po szczegółowe przykłady, lub poznaj Agentów aby zrozumieć co robi każdy specjalista.

Wymagania wstępne​

Metoda 1: Instalacja jednolinijkowa (zalecana)​

Metoda 2: Ręczna instalacja przez bunx​

Presety​

Co zostaje utworzone​

Metoda 3: Instalacja globalna​

Homebrew (macOS/Linux)​

npm / bun global​

Instalacja narzędzi AI CLI​

Gemini CLI​

Claude Code​

Codex CLI​

Qwen CLI​

oma-config.yaml​

Referencja pól​

Priorytet rozwiązywania dostawcy​

Weryfikacja: oma doctor​

Aktualizacja​

Aktualizacja CLI​

Aktualizacja umiejętności projektu​

Co dalej​