- Rust 93.8%
- Python 2.7%
- PowerShell 1.3%
- TypeScript 0.9%
- Shell 0.5%
- Other 0.7%
ead3a2ad62
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Restore types the agent's resume command into a fresh shell that herdr made for it. That shell outlived the agent, so every restored agent that later exited left an empty shell pane behind. The typed line now ends in the shell's own exit-on-success form (` && exit` for the sh family and csh/tcsh, `; and exit` for fish), so a clean exit closes the pane the way a spawned agent's pane closes, while a failed resume or a crash keeps the shell and its output. Shells whose syntax for this is unknown (nu, PowerShell, cmd, others) get the command alone, as before. The line starts with a space so shells that skip such lines keep it out of history. |
||
|---|---|---|
| .agents/skills | ||
| .cargo | ||
| .githooks | ||
| .github | ||
| .pi | ||
| .zed | ||
| assets | ||
| crates/ghostty-vt | ||
| distribution | ||
| docs | ||
| nix | ||
| packaging/windows | ||
| scripts | ||
| skills/herdr | ||
| src | ||
| tests | ||
| vendor | ||
| .gitattributes | ||
| .gitignore | ||
| .woodpecker.yml | ||
| AGENTS.md | ||
| build.rs | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| clippy.toml | ||
| CONTRIBUTING.md | ||
| flake.lock | ||
| flake.nix | ||
| justfile | ||
| LICENSE | ||
| README.md | ||
| README.zh-CN.md | ||
| rust-toolchain.toml | ||
| SPONSORS.md | ||
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
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:
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: hey@herdr.dev
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
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.