hooks

Hook Development Rules

1. Przejdź do katalogu .claude/hooks/ w swoim projekcie Claude. Jeśli folder nie istnieje, utwórz go.

2. Utwórz shell wrapper (plik .sh) — na przykład my-hook.sh. Skopiuj szablon z dokumentacji: zacznij od #!/bin/bash, ustaw set -e, przejdź do .claude/hooks/ i przekaż stdin do handlera TypeScript za pośrednictwem npx tsx.

3. Utwórz handler TypeScript (plik .ts) — na przykład my-handler.ts. Zdefiniuj interfejs HookInput dla pól specyficznych dla zdarzenia, odczytaj JSON ze stdin, przetwórz dane i zwróć obiekt z polami result ("continue" lub "block") oraz opcjonalnym message.

4. Wybierz zdarzenie, na które chcesz reagować: PreToolUse (przed wykonaniem narzędzia, może blokować), PostToolUse (po wykonaniu), UserPromptSubmit (przed przetworzeniem promptu), PreCompact (przed kompakcją kontekstu), SessionStart (przy starcie/wznowieniu sesji) lub Stop (gdy agent się zatrzyma).

5. Przetestuj hook ręcznie z linii poleceń — na przykład echo '{"type": "resume"}' | .claude/hooks/session-start-continuity.sh — aby upewnić się, że handler poprawnie parsuje input i zwraca JSON.

6. Zarejestruj hook w pliku .claude/settings.json pod kluczem hooks, podając nazwę zdarzenia, opcjonalny matcher (wzorzec filtrujący) i ścieżkę do shell wrappera. Po zapisaniu ustawień hook będzie automatycznie wywoływany w odpowiednim momencie lifecycle'u agenta.