Herdr - co to jest i jak działa? Terminal dla agentów AI

Co to jest Herdr?

Herdr to multiplekser terminala napisany z myślą o agentach kodujących. Sam producent opisuje go jako runtime, na którym żyją Twoje agenty AI, niezależnie od tego, czy pracujesz na laptopie, na desktopie, czy na wynajętej maszynie.

Od klasycznego terminala odróżnia go jedna rzecz: sesje przeżywają rozłączenie sieci i restart maszyny. Zamykasz laptopa, wracasz z innego urządzenia i zastajesz te same procesy w tym samym stanie. Agent, który w międzyczasie pisał kod, po prostu pracował dalej.

Druga różnica to świadomość tego, co działa w środku. Herdr rozpoznaje procesy uruchomione w panelach jako agenty i pokazuje ich stan, zamiast traktować je jak dowolny proces w terminalu.

Projekt jest otwarty, na licencji Apache 2.0, i działa na macOS, Linuksie i Windowsie.

Jak działa Herdr?

Herdr działa w modelu klient-serwer. Uruchomienie polecenia herdr w terminalu podłącza Cię do sesji działającej w tle na serwerze. Odłączenie się (detach) zamyka tylko klienta, natomiast serwer i procesy w panelach pracują dalej. Przy ponownym uruchomieniu klient podłącza się (attach) do domyślnej sesji i odtwarza przestrzenie robocze, karty i panele z żywymi procesami.

Pracę porządkuje prosta hierarchia:

• sesja - trwały kontener, w którym żyje cała reszta,
• przestrzeń robocza (workspace) - zwykle jeden projekt,
• karta (tab) - jeden wątek pracy w projekcie,
• panel (pane) - pojedynczy terminal z uruchomionym procesem lub agentem.

Dzięki temu przełączenie się między dwoma projektami to zmiana przestrzeni roboczej, a nie ręczne odtwarzanie kilkunastu otwartych terminali.

Na tę strukturę Herdr nakłada śledzenie stanu agentów. Każdy rozpoznany agent raportuje jeden z czterech stanów: working, blocked, idle i done. To pozwala jednym spojrzeniem zobaczyć, który agent czeka na Twoją decyzję, a który wciąż pracuje.

Jakie funkcje oferuje Herdr?

• Trwałe terminale - procesy działają na serwerze i nie giną razem z zamkniętym oknem czy zerwanym połączeniem.
• Rozpoznawanie agentów - Herdr wykrywa około dwudziestu agentów kodujących out of the box, w tym Claude Code, Codex, Cursor, Copilot, opencode, Grok, Pi i Hermes.
• Stany agentów - working, blocked, idle, done, widoczne obok listy paneli.
• Tryb zdalny - lokalny terminal działa jako cienki klient serwera Herdr na innej maszynie, przez most SSH.
• CLI i socket API - jak podkreśla dokumentacja, wiersz poleceń i socket API to ta sama powierzchnia, którą sterują agenty.
• Wtyczki - marketplace społecznościowy z ponad siedmiuset pozycjami.

Jak zainstalować Herdr?

Na macOS i Linuksie wystarczy jedno polecenie:

curl -fsSL https://herdr.dev/install.sh | sh

Na Windowsie odpowiednikiem jest instalator PowerShell:

irm https://herdr.dev/install.ps1 | iex

Poza tym dostępne są instalacja przez Homebrew, przez Nix oraz ręczne pobranie pliku binarnego. Aktualna wersja w chwili pisania tego tekstu to v0.8.2, więc projekt jest wciąż przed jedynką - warto to wziąć pod uwagę, planując wykorzystanie go w krytycznym procesie.

Jak działają trwałe sesje w Herdr?

Trwała sesja to proces serwera działający na Twojej maszynie, w którym żyją wszystkie panele. Uruchamiasz zadanie, odłączasz się poleceniem detach, zamykasz terminal, a proces pracuje dalej. W dowolnym momencie wracasz przez attach i sprawdzasz, co się wydarzyło.

Ma to trzy praktyczne konsekwencje:

• Długie zadania przestają być ryzykiem - kompilacja, migracja bazy czy przetwarzanie danych nie przerywa się przy zerwaniu sieci ani przy uśpieniu laptopa.
• Agent pracuje bez nadzoru - zlecasz zadanie, odłączasz się i wracasz do gotowego wyniku albo do agenta w stanie blocked, który czeka na Twoją decyzję.
• Zmiana urządzenia nie kosztuje kontekstu - ta sama sesja jest dostępna z domu i z biura, bez odtwarzania układu okien.

Panele są zwykłymi terminalami PTY, więc agenty i narzędzia zachowują się dokładnie tak jak w normalnym terminalu, bez gubienia sekwencji sterujących.

Jak używać Herdr w pracy zdalnej i przez SSH?

Herdr ma wbudowany tryb zdalny, który zamienia lokalny terminal w cienkiego klienta serwera działającego na innej maszynie, z mostem SSH pod spodem. W praktyce oznacza to, że serwer Herdr stoi na VPS-ie albo na mocnej stacji roboczej, a Ty podłączasz się do niego z laptopa.

Taki układ ma dwie zalety. Po pierwsze, ciężka praca dzieje się na maszynie, która i tak działa całą dobę, więc agent nie przestaje pracować, kiedy zamykasz laptopa. Po drugie, dostęp do tej samej sesji masz z każdego urządzenia, na którym możesz się zalogować przez SSH.

Jak korzystać z wtyczek w Herdr?

Herdr ma otwarty marketplace wtyczek. W chwili pisania tego tekstu indeks obejmuje 705 wtyczek z 694 repozytoriów. Instalacja odbywa się poleceniem:

herdr plugin install

Publikowanie jest równie proste i celowo pozbawione kolejki akceptacyjnej: wystarczy dodać publicznemu repozytorium na GitHubie topic herdr-plugin i umieścić w nim manifest herdr-plugin.toml. Indeks wyłapuje takie repozytorium przy kolejnym odświeżeniu.

Ta otwartość ma jednak drugą stronę, o której warto pamiętać: listingi nie są weryfikowane przez zespół Herdr. Wtyczka działa w Twoim terminalu, z Twoimi uprawnieniami i dostępem do Twojego kodu, więc przed instalacją czegokolwiek spoza znanych źródeł wypada zajrzeć do repozytorium.

Jak zautomatyzować pracę przez API Herdr?

Herdr udostępnia socket API, które obsługuje tę samą powierzchnię co wiersz poleceń: tworzenie i zamykanie sesji, zarządzanie przestrzeniami roboczymi, kartami i panelami oraz sterowanie agentami.

Praktyczne zastosowania to skrypt, który po starcie systemu odtwarza kompletne środowisko projektu, automatyczne uruchamianie agenta w dedykowanym panelu po wpadnięciu nowego zgłoszenia albo integracja z własnym narzędziem do wdrożeń, które odpala polecenia w konkretnych panelach i zbiera wyniki.

Ponieważ API i CLI to ta sama powierzchnia, każdą operację można najpierw sprawdzić ręcznie w terminalu, a dopiero potem przenieść do skryptu.

Czym Herdr różni się od tmux i innych menedżerów agentów?

Wobec tmux różnica nie leży w multipleksacji, bo model sesji, kart i paneli jest podobny. Herdr dokłada do niego warstwę świadomą agentów: rozpoznaje, że w panelu działa Claude Code czy Codex, śledzi jego stan i pokazuje go na liście. W tmux taki agent jest po prostu kolejnym procesem, a o tym, czy skończył pracę, dowiadujesz się dopiero po zajrzeniu do panelu.

Wobec menedżerów agentów i orkiestratorów różnica jest odwrotna. Tamte narzędzia skupiają się na koordynowaniu wielu agentów, ale zwykle odcinają Cię od terminala albo zamykają go w interfejsie webowym. Herdr zostaje w terminalu, którego i tak używasz, i to w nim dokłada zarządzanie agentami.

Krótko: jeśli szukasz multipleksera i nie pracujesz z agentami, tmux w zupełności wystarczy. Herdr zaczyna się opłacać wtedy, gdy równolegle chodzi kilka agentów i zaczynasz gubić się w tym, który z nich na co czeka.

Jakie są zastosowania i przykłady użycia Herdr?

• Kilku agentów naraz - każdy w osobnym panelu, ze stanem widocznym na liście, więc od razu widać, który wymaga uwagi.
• Agent plus reszta środowiska - w jednym panelu agent generuje kod, w drugim działa serwer deweloperski, w trzecim lecą logi, wszystko w jednej przestrzeni roboczej.
• Praca na wielu projektach - osobna przestrzeń robocza na projekt, przełączanie bez odtwarzania układu terminali.
• Długie zadania w tle - kompilacje, migracje i przetwarzanie danych, do których wracasz po fakcie.
• Praca z kilku urządzeń - serwer na VPS-ie, klient na laptopie w domu i na komputerze w biurze.

Jakie są najlepsze praktyki dla programistów korzystających z Herdr?

• Jedna przestrzeń robocza na projekt - izolacja kontekstu jest tu głównym źródłem porządku.
• Agent w dedykowanym panelu - łatwiej śledzić jego stan i nie miesza się z Twoimi własnymi poleceniami.
• Reaguj na stan blocked - to sygnał, że agent czeka na decyzję, i najczęstsze miejsce, w którym praca stoi bez potrzeby.
• Powtarzalne układy przenieś do skryptu - socket API pozwala odtworzyć całe środowisko jednym poleceniem.
• Sprawdzaj wtyczki przed instalacją - marketplace nie jest moderowany, a wtyczka działa z Twoimi uprawnieniami.

Jak popularny jest Herdr?

Herdr jest projektem młodym, ale rozpoznawalnym. Dane z oficjalnej strony w chwili pisania tego tekstu:

• 30 663 gwiazdki na GitHubie,
• 491 185 instalacji,
• 705 wtyczek społecznościowych,
• wersja v0.8.2, licencja Apache 2.0.

To liczby, które mówią o realnym zainteresowaniu, ale numer wersji przypomina, że projekt jest wciąż przed pierwszym stabilnym wydaniem. Jeśli rozważasz Herdr do codziennej pracy, warto zacząć od jednego projektu i sprawdzić, jak narzędzie zachowuje się przy Twoim zestawie agentów, zanim przeniesiesz do niego całe środowisko.