herdr

Agent Multiplexer That Lives in Your Terminal

Run all your coding agents in one terminal. See who's blocked, working, or done at a glance.

13,017
Stars
756
Forks
40
Subscribers
Rust
Language

What You Get

🖥️

Real Terminal per Agent

You see each agent's own screen, not an app's imitation of one, so even full-screen TUIs render right.

👁️

Agent State at a Glance

The sidebar rolls every agent up to 🔴 blocked, 🟡 working, 🔵 done, or 🟢 idle, so you always know who needs you.

📊

Workspaces, Tabs, Panes

Organize by repo or folder, click, drag, and split, mouse-native throughout.

🔄

Nothing Dies on Detach

A background server keeps panes and agents alive; detach and reattach from any terminal.

🌐

Runs Anywhere

Single ~10MB rust binary, linux and macos (windows beta), no dependencies, runs inside your terminal.

Scriptable

A local socket API and CLI that agents can drive, plus plugins you can write in any language.

How It Compares

Feature tmux GUI Managers herdr
persistent sessions
detach / reattach
runs anywhere, over ssh
panes, tabs, workspaces
agent awareness
lives in your terminal
real terminal views
mouse-native
lightweight binary
agents can orchestrate ? ?

Install

Shell Install

curl -fsSL https://herdr.dev/install.sh | sh

Windows Beta

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Homebrew

brew install herdr

Nix

nix run github:ogulcancelik/herdr

Quick Start

1

Start herdr

herdr

herdr starts or attaches to a background server and opens a workspace. Run an agent in the pane.

2

Mouse Navigation

herdr is mouse-native, so clicking and dragging panes, tabs, and split borders gets you everywhere without keybindings.

3

Keyboard Shortcuts

ctrl+b is the prefix: press it, release, then press the action key.

  • ctrl+b then shift+n - new workspace
  • ctrl+b then v or minus - split panes
  • ctrl+b then c - new tab
  • ctrl+b then w - switch workspaces
  • ctrl+b then q - detach

Remote Usage

Run herdr on a VPS and reach it from your local terminal. herdr --remote makes your local terminal the client of the remote server.

herdr --remote workbox
herdr --remote ssh://you@yourserver:2222

See the persistence and remote docs for named sessions, keepalives, direct attach, and handoff.

Supported Agents

Detection works out of the box with process-name matching plus terminal-output heuristics.

pi

claude code

codex

droid

amp

opencode

grok cli

github copilot cli

Install integrations with: herdr integration install

Agents Can Use Herdr Too

The local Unix socket lets agents create workspaces, split or zoom panes, spawn helpers, read output, and subscribe to state changes.

npx skills add ogulcancelik/herdr --skill herdr -g

Start with the agent skill docs, socket API docs and SKILL.md.

Ready to Take Control of Your Agents?

Join thousands of developers who are already using herdr to manage their coding agents.