herdr
the runtime your coding agents live on
- 45.5k stars
- 3.6k forks
- 420 open issues
- Language: Rust
- License: Apache-2.0
- updated
Install
git clone https://github.com/herdrdev/herdr && cp herdr/*.md ~/.claude/agents/- Clone the repository and copy the agent .md definitions into ~/.claude/agents (or .claude/agents inside a project).
- Start a new Claude Code session to load the agents.
- Delegate work to them with the Task/Agent tool or by name.
5 items in this repository
Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, commands, or another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.
Audit herdr release readiness by comparing commits since the base release against next-release changelog and docs. Use when asked to run or apply the repo's pre-release audit, validate docs/next before release, inspect issue refs that release CI will close, or finalize release docs for herdr.
Create and control a disposable named Herdr session from inside an existing Herdr session. Use for isolated Herdr runtime, pane, terminal, process, API, persistence, or agent reproductions that should be driven through the CLI/API without touching the default session.
Triage open herdr GitHub issues into a concise decision-first Markdown table. Use when the user says "triage", asks to triage open issues, asks which issues need attention, or wants issue priority/recommendation lights for herdr.
Subagents overview
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 | 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 →
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 checkslicense
Herdr is licensed under the Apache License 2.0.
What people ask about herdr
What is herdrdev/herdr?
herdrdev/herdr is subagents for the Claude AI ecosystem. the runtime your coding agents live on It has 45.5k GitHub stars and its last recorded update is dated 2026-10-22.
How do I install herdr?
You can install herdr by cloning the repository (https://github.com/herdrdev/herdr) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is herdrdev/herdr safe to use?
Our security agent has analyzed herdrdev/herdr and assigned a Trust Score of 97/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains herdrdev/herdr?
herdrdev/herdr is maintained by herdrdev. The last recorded GitHub activity is dated 2026-10-22, with 420 open issues.
Are there alternatives to herdr?
Yes. On ClaudeWave you can browse similar subagents at /categories/agents, sorted by popularity or recent activity.