herdr.dev · install · quick start · docs
English · 简体中文
v.0.4.0.mp4
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.
- 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.
curl -fsSL https://herdr.dev/install.sh | shor 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:
herdrrun your agents, split panes, walk away. ctrl+b q detaches, herdr reattaches. quick start →
everything lives at herdr.dev/docs: quick start · concepts · supported agents · keyboard · configuration · session state · connecting machines · remote · integrations · plugins · socket api
every past sponsor and backer is listed in SPONSORS.md — thank you 🐑
enterprise / partnership: hey@herdr.dev
This repository is a fork of herdrdev/herdr. Day-to-day installs should still follow upstream docs and releases. Branches and discussions below are local experiments and community posts, not upstream merge requests from a maintainer account.
command-surface— fork-only command-surface experiments.herdr-sleeper— standalone sleeper script path later reborn as the herdr-sleeper plugin.
- Discussion 5861 — plain-English command line (herdr-plain-line plugin).
- Discussion 2283 comment — related naming / surface notes.
- Discussion 631 — agent sleep / hibernate (herdr-sleeper).
- Discussion 1674 — native destination-picker ideas.
| Repo | Role |
|---|---|
| frdminc/herdr | Fork of herdrdev/herdr |
| herdr-plain-line | Local plugin: plain-English popup for tab/workspace rename and create |
| herdr-sleeper | Plugin: sleep idle agent panes, wake later |
| herdr4paseo | Terminal UI to watch/steer a Paseo agent from a pane |
| paseo4herdr | Paseo plugin mirroring OMP agents that run in Herdr |
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.
git clone https://github.com/herdrdev/herdr
cd herdr
cargo build --release
just test # unit tests
just check # formatting, tests, and maintenance checksHerdr is licensed under the Apache License 2.0.
