lobster

Lobster workflow runtime for deterministic pipelines with approval gates. Use when: (1) Running multi-step automations that need human approval before side effects, (2) Monitoring PRs/issues for changes, (3) Processing data through typed JSON pipelines, (4) Email triage or batch operations, (5) Any workflow that should halt and ask before acting. Lobster saves tokens by running deterministic pipelines instead of re-planning each step.

1. Zainstaluj Lobster globalnie za pomocą npm: npm install -g @clawdbot/lobster. Alternatywnie ustaw alias w terminalu wskazujący na plik binarny node /ścieżka/do/lobster/bin/lobster.js.

2. Przygotuj plik workflow w formacie .lobster lub zdefiniuj potok bezpośrednio w wierszu poleceń. Potok składa się z sekwencji komend — na przykład exec do uruchomienia skryptu, where do filtrowania danych, pick do wyboru pól, approve do zatrzymania i czekania na zatwierdzenie.

3. Uruchom potok w trybie interaktywnym: lobster 'twój-potok'. Zobaczysz czytelne wyjście i punkty zatwierdzenia. Jeśli potok zawiera komendę approve, wykonanie się zatrzyma i poprosi o decyzję.

4. Na etapie zatwierdzenia otrzymasz token wznowienia. Użyj go do podjęcia decyzji: lobster resume --token "token" --approve yes lub --approve no. To wznowi lub anuluje potok.

5. Aby zintegrować z innymi narzędziami, uruchom potok w trybie tool: lobster run --mode tool 'twój-potok'. Wyjście będzie w formacie JSON, gotowe do przetworzenia przez inne systemy.

6. Przeglądaj dostępne komendy i przepływy pracy: lobster commands.list oraz lobster workflows.list. Dokumentacja komend (exec, where, pick, sort, groupBy, template, diff.last, state.get/set) znajduje się w README projektu.