--- title: "Konfiguracja Herdr z Claude Code i Google Antigravity (AGY) - Hooki i SKILL.md (Część 2)" slug: "konfiguracja-herdr-claude-code-google-antigravity-agy" date: 2026-10-25 lastUpdated: 2026-10-30 description: "Aby agenci AI w Herdrze nie byli tylko ślepymi oknami terminala, potrzebują dwóch rzeczy: hooków cyklu życia oraz wspólnego skilla sterującego. Pokazuję krok po kroku, jak spiąć Claude Code i AGY w jeden organizm." author: "Jakub Krysmalski" canonical: "https://krysmalski.pl/blog/konfiguracja-herdr-claude-code-google-antigravity-agy" tags: - "AI" - "Automatyzacja" - "Webdev" --- Aby agenci AI uruchomieni w **Herdrze** nie byli tylko odizolowanymi oknami terminala, potrzebują dwóch elementów: **natywnych hooków cyklu życia** (raportujących stany `working`, `idle` i `blocked`) oraz **wspólnego skilla `SKILL.md`** (uczącego agentów, jak sterować multiplekserem). W drugiej części serii spinamy **Claude Code** oraz **Google Antigravity CLI (`agy`)** w jeden organizm. **Wszystkie części poradnika (Orkiestracja Claude Code + AGY w Herdr):** - **Część 1:** [Herdr zamiast tmux - instalacja i pierwsze kroki z terminalem dla agentów AI](/blog/herdr-instalacja-terminal-dla-agentow-ai) - **Część 2 (czytany wpis):** Konfiguracja Herdr z Claude Code i Google Antigravity (AGY) - Hooki i SKILL.md - **Część 3:** [Orkiestracja w praktyce: Gemini 4 Argon i Claude Opus dyrygują flotą Flash, Sonnet i Haiku w Herdr](/blog/orkiestracja-agentow-ai-herdr-gemini-argon-claude-sonnet-haiku) ## Dwa filary integracji: raportowanie stanu (Hooks) oraz sterowanie (Skill) W [pierwszej części serii](/blog/herdr-instalacja-terminal-dla-agentow-ai) zainstalowaliśmy **Herdr v0.9.5**. Sam multiplekser potrafi rozpoznawać agentów na podstawie tego, co wyświetlają na ekranie terminala, ale pełną moc zyskujemy dopiero wtedy, gdy: 1. **Zainstalujemy natywne hooki (`herdr integration install`):** Agenci `claude` oraz `agy` zaczynają sami wysyłać sygnały do gniazda Herdr w ułamku sekundy, gdy zaczynają myśleć (`working`), czekają na zgodę użytkownika (`blocked`) lub kończą turę (`idle`). 1. **Wygenerujemy i podepniemy `SKILL.md` (`herdr --skill`):** Zarówno Claude Code, jak i Google Antigravity dowiadują się, jak używać CLI Herdra do dzielenia ekranu, spawnowania workerów i odczytywania ich odpowiedzi. ## Krok 1: Instalacja natywnych hooków dla Claude Code i Antigravity CLI Najnowszy Herdr posiada wbudowany menedżer integracji dla najpopularniejszych agentów. Sprawdzamy listę wspieranych integracji i od razu instalujemy wtyczki dla **Claude Code** oraz **Antigravity CLI**: ```bash # Instalacja hooka statusu dla Claude Code herdr integration install claude # Instalacja hooka statusu dla Google Antigravity CLI (agy) herdr integration install antigravity-cli # Weryfikacja zainstalowanych wtyczek herdr integration status | grep -E 'claude|antigravity' ``` Co dokładnie zrobił Herdr pod maską? - Dla **Claude Code** utworzył skrypt `/Users/kub/.claude/hooks/herdr-agent-state.sh` i zarejestrował go w `~/.claude/settings.json`. - Dla **Google Antigravity (`agy`)** utworzył skrypt `/Users/kub/.gemini/config/hooks/herdr-agent-state.sh` i dopisał konfigurację do `~/.gemini/config/hooks.json`. ## Krok 2: Instalacja wspólnego skilla dla obu środowisk Aby nasz główny agent (Orchestrator) potrafił samodzielnie wydawać polecenia multiplekserowi Herdr, eksportujemy wbudowany skill prosto z binarki `herdr --skill` do globalnych katalogów skilli AGY oraz Claude: ```bash mkdir -p ~/.gemini/config/skills/herdr ~/.claude/skills/herdr herdr --skill | tee ~/.gemini/config/skills/herdr/SKILL.md > ~/.claude/skills/herdr/SKILL.md ``` Dlaczego generujemy plik bezpośrednio przez `herdr --skill`? Ponieważ definicja skilla jest zawsze w 100% zgodna z wersją protokołu Twojej zainstalowanej binarki Herdr. ## Krok 3: Podgląd wygenerowanych hooków oraz dobór modeli w AGY i Claude Zajrzyjmy do pliku `~/.gemini/config/hooks.json` oraz sprawdźmy listę modeli dostępnych w naszym środowisku (`agy models`): ```bash cat ~/.gemini/config/hooks.json agy models ``` Dzięki temu, że w `agy` oraz `claude` mamy dostęp do pełnego przekroju modeli, możemy zaprojektować optymalną architekturę kosztowo-wydajnościową: - **Orchestrator (Kapitan):** **Gemini 4 Argon (High)** (`agy --model gemini-4-argon-high`) lub **Claude Opus 5.5 (High)** (`agy --model claude-opus-5-5-high` / `claude --model opus`) - odpowiada za architekturę, podział zadań, weryfikację diffów i syntezę wyników. - **Worker 1 (Szybkie R&D i eksploracja):** **Gemini 3.8 Flash (High)** (`agy --model gemini-3.8-flash-high`) - błyskawicznie przeszukuje repozytorium i analizuje schematy. - **Worker 2 (Implementacja UI / Fullstack):** **Claude Sonnet 5.5** (`claude --model sonnet`) - pisze i refaktoryzuje komponenty React/Next.js. - **Worker 3 (Audyt, testy, szybkie sprawdzenia):** **Claude Haiku 5.5** (`claude --model haiku`) - wykonuje tanie, kilkusekundowe zadania (koszt rzędu `$0.01` za sesję). W [trzeciej części serii](/blog/orkiestracja-agentow-ai-herdr-gemini-argon-claude-sonnet-haiku) uruchomimy tę flotę w praktyce na żywym projekcie Next.js + Sanity i zobaczymy, jak Orchestrator rozdziela pracę pomiędzy 4 panele. ## Często zadawane pytania (FAQ) ### Czy po aktualizacji binarki Herdr muszę ręcznie aktualizować pliki hooków i skilla? Po wykonaniu `herdr update` warto uruchomić `herdr integration status` (aby sprawdzić, czy hooki mają status `current`) oraz odświeżyć plik `SKILL.md` poleceniem `herdr --skill`. ### Czy hook Herdra w ~/.gemini/config/hooks.json nadpisze moje własne hooki w AGY? Nie. System `hooks.json` w Antigravity obsługuje wiele nazwanych kluczy na najwyższym poziomie (np. `herdr`, `lint-checker`) i łączy je sekwencyjnie podczas wykonania. ### Jak przekazać flagę wyboru modelu do agenta uruchamianego przez Herdr? W poleceniu `herdr agent start --kind --pane ` dodaj separator `--`, a po nim natywne flagi CLI danego agenta, np. `-- --model gemini-4-argon-high` lub `-- --model haiku`. ## Źródła - Herdr Agent Guide: [Herdr Integrations & Agent Skill Guide](https://herdr.dev/agent-guide.md) - Google Antigravity Docs: [Lifecycle Hooks (hooks.json) & Skills](https://antigravity.google/docs/hooks) --- *Wpis pochodzi z serwisu [krysmalski.pl](https://krysmalski.pl/blog/konfiguracja-herdr-claude-code-google-antigravity-agy)*