herdr

herdr.dev · install · quick start · docs

English · 简体中文

---

Important

This repository is the aceitw/herdr fork. See FORK.md for its additional workspace/tab swapping, sidebar customization, installation, and terminal compatibility notes.

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

the Herdrup fork

This fork adds the daemon features the Herdrup iOS app uses: Gram (owner and agent messaging), push notifications, and the live streaming terminal. The upstream install above is the base daemon, without those. The Herdrup installer downloads the matching prebuilt fork binary and verifies its checksum, so normal users do not need Rust, Cargo, or Zig.

curl -fsSL https://herdrup.themartian.app/install.sh | sh

Then run herdr where your agents live:

herdr          # the interactive TUI
# or: herdr server   for a headless server

Now run herdr pair and scan the code from the Herdrup app. Building from source remains a developer path and requires the repository's pinned Rust and Zig toolchains.

To update later, run the installer again, or herdr channel set preview once and then herdr update. Herdrup publishes only preview builds, so the stable channel refuses to update instead of installing upstream Herdr over the fork.

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.