Vytvořeno: 12.9.2026 | Aktualizováno: 12.09.2026 12:53
Herdr je terminálový workspace manager a runtime pro coding agenty. Udržuje jejich skutečné terminálové procesy na pozadí, seskupuje je do projektových workspace a zobrazuje jejich stav i po odpojení klienta.
Herdr nenahrazuje ani neobaluje samotné coding agenty. Spravuje terminály, ve kterých běží, a přidává nad nimi pracovní prostor pro více projektů, panelů a strojů. Podporuje například Claude Code, Codex a OpenCode.
Základní hierarchie podle dokumentace konceptů je:
Rozhraní ukazuje stav agentů working, blocked, done, idle nebo unknown. Stav blocked znamená, že agent potřebuje vstup, schválení nebo rozhodnutí.
Herdr je dostupný pro macOS, Linux a Windows. Oficiální instalační skript pro Unixové systémy:
curl -fsSL https://herdr.dev/install.sh | sh
V adresáři projektu se spustí příkazem:
herdr
Podle quick startu se tím vytvoří nebo připojí výchozí serverová relace na pozadí. V novém panelu lze spustit například claude, codex nebo opencode; Herdr je rozpozná a zobrazí jejich stav.
Klienta lze odpojit klávesami Ctrl+b, potom q, nebo prostým zavřením terminálového okna. Server a procesy v jeho panelech pokračují. K relaci se lze znovu připojit opět příkazem herdr. Úplné ukončení relace a jejích panelů provede:
herdr server stop
Herdr je užitečný, když v jednom projektu běží více agentů nebo když je potřeba sledovat práci napříč repozitáři. Každému projektu může odpovídat samostatný workspace; panely lze rozdělovat vodorovně i svisle a práce agentů zůstává viditelná na jednom místě.
CLI a socket API dovolují agentům i skriptům vytvářet workspace a panely, spouštět rozpoznané agenty, posílat jim prompty, číst výstup a čekat na konkrétní stav. To umožňuje řídit běh pomocných agentů podle skutečného stavu místo slepého posílání kláves do terminálu.
Připojení strojů přes SSH umožňuje zobrazit lokální a vzdálené workspaces v jednom okně. Každý stroj si ponechává vlastní Herdr server, relace a procesy; výpadek jednoho SSH spojení proto neodpojí ostatní stroje.
Pro přidání vzdáleného stroje je potřeba funkční běžný přístup přes SSH. Interaktivní nastavení například pro host workbox je:
herdr machine add workbox --label "Build machine"
Podpora více strojů je podle dokumentace ověřená pro klienty Linux a macOS a vzdálené servery Linux a macOS na architekturách x86_64 nebo aarch64. Windows zatím není podporován jako SSH cíl pro tento režim.
Při běžném odpojení klienta zůstává Herdr server běžet a s ním i shell, agent, test nebo jiný proces v panelu. Je to nejsilnější běžný režim, protože původní procesy nepřerušuje. Experimentální live handoff může při úspěchu zachovat procesy i při výměně serveru.
Obnova relace po restartu serveru obnoví strukturu workspace, tabů, panelů, pracovní adresáře a layout, ale ne běžící libovolné procesy. Podporovaným agentům může Herdr obnovit jejich vlastní konverzační relaci, pokud poskytly platný odkaz přes oficiální integraci. Historii obsahu panelů lze zapnout experimentálním nastavením, ale může obsahovat tokeny, prompty a výstupy příkazů; adresář s daty relace je proto potřeba chránit stejně jako historii terminálu.
Herdr tedy nenahrazuje správu dlouhodobých služeb ani plánovač úloh. Je vhodný hlavně pro interaktivní, dlouhotrvající práci s coding agenty a terminály.
Zdrojový kód Herdru je veřejný na GitHubu a projekt používá licenci Apache-2.0.