====== Herdr ======

//Vytvořeno: **12.9.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://herdr.dev/|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.

===== Co Herdr řeší =====

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 [[https://herdr.dev/docs/concepts/|dokumentace konceptů]] je:

  * **workspace** je kontejner pro repozitář, úkol nebo průzkum;
  * **tab** je rozložení panelů ve workspace;
  * **pane** je skutečný terminál s běžícím procesem;
  * **agent** je rozpoznaný proces coding agenta v panelu.

Rozhraní ukazuje stav agentů ''working'', ''blocked'', ''done'', ''idle'' nebo ''unknown''. Stav ''blocked'' znamená, že agent potřebuje vstup, schválení nebo rozhodnutí.

===== Instalace a první spuštění =====

Herdr je dostupný pro macOS, Linux a Windows. Oficiální instalační skript pro Unixové systémy:

<code bash>
curl -fsSL https://herdr.dev/install.sh | sh
</code>

V adresáři projektu se spustí příkazem:

<code bash>
herdr
</code>

Podle [[https://herdr.dev/docs/quick-start/|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:

<code bash>
herdr server stop
</code>

===== Práce s více agenty =====

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ě.

[[https://herdr.dev/docs/agent-automation/|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.

===== Více strojů =====

[[https://herdr.dev/docs/connecting-machines/|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:

<code bash>
herdr machine add workbox --label "Build machine"
</code>

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.

===== Perzistence a omezení =====

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. [[https://herdr.dev/docs/session-state/|Experimentální live handoff]] může při úspěchu zachovat procesy i při výměně serveru.

[[https://herdr.dev/docs/session-state/|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 a licence =====

[[https://github.com/herdrdev/herdr|Zdrojový kód Herdru]] je veřejný na GitHubu a projekt používá licenci Apache-2.0.

===== Zdroje =====

  * [[https://herdr.dev/|Herdr – oficiální web]]
  * [[https://herdr.dev/docs/quick-start/|Herdr – Quick start]]
  * [[https://herdr.dev/docs/concepts/|Herdr – Concepts]]
  * [[https://herdr.dev/docs/agent-automation/|Herdr – Agent automation]]
  * [[https://herdr.dev/docs/session-state/|Herdr – Session state and restore]]
  * [[https://herdr.dev/docs/connecting-machines/|Herdr – Connecting machines]]
  * [[https://github.com/herdrdev/herdr|herdrdev/herdr – GitHub repozitář]]