herdrdev /
herdr
A terminal multiplexer that keeps your coding agents running and shows which one is stuck
- 45.4k stars
- 3.5k stars since 3 Oct
- Rust
- Updated today
- Some experience
- Coding agents & dev tools
If you run several coding agents at once, such as Claude Code or Codex, you end up with a pile of terminal tabs. Some agents are working, some are waiting for an answer, and it is hard to tell which is which. Closing your laptop or losing an SSH connection can also interrupt the work.
herdr runs a background server that owns the terminals. You attach a client to it, split panes, and start your agents inside them. Closing the client or dropping SSH leaves the terminals running, and you reattach later by typing herdr again. Each pane is labeled working, blocked or idle. You can also add saved SSH machines and see local and remote agents in one window.
It does not wrap or replace your agents. It manages their terminals, much as tmux does, but it adds agent status and a CLI and socket API. Agents can use that API to open panes, send prompts to each other, and wait until another agent is blocked. It ships as one Rust binary and runs inside the terminal you already use.
What it does
Detach and reattach
Terminals keep running in a background server when you close the client or lose SSH. After a server or machine restart, herdr restores the saved layout and can resume supported agent sessions, but the original processes do not survive.
Agent status per pane
Every pane is marked working, blocked or idle, and herdr tells you when an agent stops and needs an answer.
Local and remote in one window
Local work and saved SSH machines appear together with a combined agent list. Each machine reconnects independently.
Agents can drive it
A CLI and socket API let agents spawn panes, prompt one another, and wait for another agent to be blocked. An agent skill is available.
Keyboard and mouse
It supports tmux-style prefix keys as well as clicking, dragging and splitting. Plugins can extend panes and workflows.
What you could build
- Run several Claude Code or Codex sessions side by side and see which one is waiting for you.
- Start a long agent task on a remote server and reattach after your SSH connection drops.
- Manage agents on your laptop and on saved SSH machines from a single window.
- Let one agent spawn helper panes and prompt other agents through the CLI or socket API.
- Add herdr support to an agent you are building so it reports its status.
Get started
Install with the script (Homebrew and mise also work), then run herdr in the directory where you work. Start your agents in panes. Press ctrl+b q to detach and run herdr again to reattach.
curl -fsSL https://herdr.dev/install.sh | shherdrCommands are copied from the project's README. Read it on GitHub for the full setup.
More in Coding agents & dev tools
rea
MCP server that lets AI agents reverse engineer apps, binaries and websites locally
opencode
Open source AI coding agent for your terminal, with a beta desktop app
claude-code
Terminal coding assistant that reads your codebase and takes plain-English commands
codex
A coding agent from OpenAI that runs in your terminal on your own machine
pi
A minimal terminal coding agent you extend with skills, extensions and packages
orca
Desktop and mobile app for running many coding agents side by side
Understand-Anything
Turns a codebase or wiki into an interactive graph you can search and ask questions about
screenshot-to-code
Turns screenshots, mockups and screen recordings into front-end code with AI models
warp
Rust terminal that adds a built-in coding agent and runs other CLI agents
free-claude-code
Local proxy that lets Claude Code, Codex, Aider and others run on free or cheap models