herdr

tmux for agents.

herdr is an agent multiplexer that lives in your terminal.

workspaces, tabs, panes. mouse-native: click, drag, split. every agent at a glance: blocked, working, done. detach and reattach, agents keep running. no gui app, no electron, no mac-only native wrapper. you see the agent's own terminal, not someone's interpretation of it.

$ curl -fsSL https://herdr.dev/install.sh | sh
github · docs · api · linux · macos · agpl-3.0

how it compares

tmux gui managers herdr
persistent sessions ✓ — ✓
detach / reattach ✓ — ✓
panes, tabs, workspaces ✓ ✓ ✓
agent awareness — ✓ ✓
lives in your terminal ✓ — ✓
real terminal views ✓ — ✓
mouse-native — ✓ ✓
lightweight binary ✓ — ✓
agents can orchestrate ? ? ✓

persistence

start herdr on your desktop or server. run your agents, split panes, do your work. press ctrl+b q to detach. close your terminal, close your laptop; your agents keep running. open a new terminal, run herdr, you're back. same session, same panes, same agents.

from anywhere

need to check on your agents from your phone? just ssh in and run herdr. any ssh client works. no app to download, no account to create.

$ ssh you@yourserver
$ herdr
same session, same agents, same state.

agent awareness

workspaces

workspaces

each workspace rolls up to its most urgent state. scan the full list in a glance.

agents

agents

see which agents are running, blocked, or finished. no checking panes one by one.

blocked
working
done
idle

lives in your terminal

not a gui window. not a web dashboard. not electron. herdr runs inside whatever terminal you already use. a single rust binary, no dependencies, nothing to configure. it even works inside tmux.

ghostty alacritty kitty wezterm iterm2 tmux

supported agents

agent idle / done working blocked
pi ✓ ✓ partial
claude code ✓ ✓ ✓
codex ✓ ✓ ✓
droid ✓ ✓ ✓
amp ✓ ✓ ✓
opencode ✓ ✓ ✓
gemini cli detected, not fully tested
cursor agent detected, not fully tested
cline detected, not fully tested

socket api

agents can use herdr too. the local unix socket lets agents create workspaces, split panes, spawn other agents, read output, and wait for state changes.

available as CLI commands or as a reusable agent skill.

socket api → agent skill → 
# create a workspace and tab
herdr workspace create --cwd ~/project --label "api"
herdr tab create --label "logs"

# split a pane and run
herdr pane split 1-1 --direction right
herdr pane run 1-2 "npm test"

# wait for an agent
herdr wait agent-status 1-1 --status done

# read output
herdr pane read 1-2 --source recent --lines 50