the runtime your coding agents live on

★ 51,152⑂ 4,139👁 119⑃ 1,179● 2,931▤ 98
RustApache-2.0Created 2026-03-27herdr.dev
Download: v0.9.5v0.9.5 ↓0.9.52026-10-14
+195
Daily
+1,586
Weekly
51,152
stars
4,139
forks
119
watchers
1,179
prs
2,931
issues
98
releases

README

herdr



  



  herdr.dev · install · quick start · docs



  English · 简体中文



  
  
  
  
  
  


---

https://github.com/user-attachments/assets/043ec09f-4bdd-41d5-aee0-8fda6b83e267

the runtime your coding agents live on.

- detach without stopping work — herdr keeps terminals running in a background server when you close the client or lose your SSH connection. after a server or machine restart, herdr restores the saved layout and can resume supported agent sessions; the original processes do not survive. session state →
- several machines, one window — keep local work and saved ssh machines together, with a combined agent list and independent reconnects. remote machines →
- never hunt for the stuck one — every pane is marked working, blocked, or idle. when an agent stops and needs an answer, herdr says so.
- agent-native — agents drive herdr through the cli and socket api: they can spawn panes, prompt each other, and wait until another agent is genuinely blocked. agent skill →
- runs what you already run — claude code, codex, cursor, opencode, grok and the rest. herdr doesn't wrap or replace them; it owns their terminals. building an agent? add herdr support →
- keyboard and mouse, both first-class — tmux-style prefix keys and click, drag, split. pick per moment, not per tool.
- plugins — extend panes and workflows. browse the marketplace →
- one rust binary, no electron — runs in whatever terminal you already use.

---

 install

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


or brew install herdr · mise use -g herdr · windows: powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex" · endpoint-protected Windows · binaries

then start it where the work lives:

bash
herdr


run your agents, split panes, walk away. ctrl+b q detaches, herdr reattaches. quick start →

 docs

everything lives at herdr.dev/docs: quick start · concepts · supported agents · keyboard · configuration · session state · connecting machines · remote · integrations · add herdr support to your agent · plugins · socket api

 thanks

every past sponsor and backer is listed in SPONSORS.md — thank you 🐑

enterprise / partnership: [email protected]

 agent instructions

if you are an ai agent helping with this repository, read AGENTS.md before making changes and read CONTRIBUTING.md before opening issues or PRs.

 development

bash
git clone https://github.com/herdrdev/herdr
cd herdr
cargo build --release

just test         unit tests
just check        formatting, tests, and maintenance checks


 license

Herdr is licensed under the Apache License 2.0.

Top issues

Discussions

Latest release

v0.9.5 v0.9.5 2026-10-14
This is a hotfix release for v0.9.4. See the v0.9.4 notes for the full feature release: https://github.com/herdrdev/herdr/releases/tag/v0.9.4

 Fixed
- Prefix shortcuts work again when the terminal sends the next key as plain text. This affected Tern, Chinese, Japanese and Korean input methods on macOS, and Ghostty text: keybinds that send the prefix and a key together. Workspace navigation had the same problem. (5255)
- Codex sessions no longer start with a "clamping Interrupt hook timeout" warning. Herdr no longer installs Codex turn hooks, and Codex status comes from screen detection again.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON