Your machine
Start a local session, split panes, create tabs, and keep agents running while your terminal comes and goes.
$ herdrAgent multiplexer · lives in your terminal
One terminal. The whole herd.
Herdr is to coding agents what tmux is to terminals: a multiplexer that runs where your agents run — your machine, your server, anywhere you can ssh. See blocked, working, and done at a glance, click anything, close the laptop. Nothing dies.
Stable install
$
curl -fsSL https://herdr.dev/install.sh | sh
Windows beta · preview only
Preview docs
PS>
irm https://herdr.dev/install.ps1 | iex
Stable Linux/macOS · Windows preview beta · no Electron
opencodeherdr+
✻ Claude Code v2.1.168
~/Projects/herdr · master
❯ the sidebar flickers when an agent flips state fast
● Found it. The rollup recomputes on every PTY chunk, so a double state flip repaints the dot mid-frame.
● Plan:
· src/app/state.rs — buffer state events per tick
· src/ui/sidebar.rs — repaint rollups once per frame
❯ go, and add a regression test
⠋ Working… (13m 36s · esc to interrupt)
❯
~/Projects/herdr > master > ctx ─── 3% 34k/1M
>> bypass permissions on (shift+tab to cycle)
~/Projects/herdr master
❯ bun run dev
$ node scripts/prepare-docs.mjs && astro dev
02:10:44 [types] Generated 0ms
02:10:44 [content] Synced content
astro v5.18.1 ready in 668 ms
┃ Local http://localhost:4321/
Network use --host to expose
02:10:44 watching for file changes...
+ Thought: 468ms
→ Read src/main.rs
+ Thought: 292ms
This is src/main.rs — the entry point for herdr. Here's what it does:
1. Arg parsing — session::configure_from_args, then remote args for the SSH bridge.
2. Subcommand dispatch — server, client, update — each returns early.
3. Session mode — auto_detect_launch() connects to a running server or spawns one.
Build · MiMo V2.5 Free · 16.6s
Build · MiMo V2.5 Free OpenCode Zen
25.2K (13%) ctrl+p commands
migratelogs+
✻ Claude Code v2.1.168
~/Projects/llm-proxy · master
❯ prep the request-log migration and run it
● Wrote migrations/0007_request_log.sql — request_log table, retention index on created_at, daily rollup view.
● Local checks pass: sqlx prepare is clean, backfill dry-run touches 41,209 rows. Ready to apply.
~/Projects/llm-proxy master
❯ tail -f logs/proxy.log
02:30:58 INFO request id=4818 route=/v1/messages 200 312ms
02:31:04 INFO request id=4819 route=/v1/messages 200 287ms
02:31:09 DEBUG cache hit ratio 0.93
02:31:12 INFO request id=4820 route=/v1/messages 200 301ms
02:31:15 WARN upstream latency p99 1.8s
02:31:18 INFO request id=4821 route=/v1/messages 200 295ms
02:31:21 WARN 429 from upstream, retrying in 2s
02:31:24 INFO request id=4822 route=/v1/messages 200 1102ms
02:31:30 DEBUG cache hit ratio 0.94
02:31:33 INFO request id=4823 route=/v1/embeddings 200 88ms
codexserver+
• Explored
└ Read live_handoff.rs
• Ran
└ cargo nextest run -E 'test(live_handoff)'
└ 14 passed · 0 failed · 41.3s
• The handoff suite passes. Pane PTYs survive server replacement, and long-lived workloads — including the http.server in the next tab — keep responding afterward.
• Next I can wire the soak test into nightly CI and fail on p95 regressions. Want that?
›
gpt-5.5 medium · ~/qmp · master · Context 6% used
~/qmp master
❯ python3 -m http.server 8080
Serving HTTP on 0.0.0.0 port 8080 ...
02:28:41 "GET /runs/latest.json" 200
02:29:03 "GET /runs/latest.json" 200
02:29:25 "GET /qmp/report.html" 200
02:30:07 "GET /runs/latest.json" 200
02:30:18 "GET /favicon.ico" 404
02:30:42 "GET /qmp/report.html" 200
02:31:09 "GET /runs/latest.json" 200
# used in the wild
Popular with engineers from
JetBrains
Docker
Vercel
Kimi
Sentry
Google
NVIDIA
AWS
ByteDance
Tencent
Alibaba
Salesforce
IBM
Atlassian
Whop
Automattic# not an app
Runs where your agents run.
Desktop agent managers are stuck on the machine with the GUI. Herdr is a client–server multiplexer: agents live on whichever box does the work, and you attach from anywhere — your laptop, any SSH client, even a phone.
Any SSH client
Use Herdr like tmux on a remote box. The session stays on the server after you detach.
$ ssh you@server
$ herdrRemote attach
Point your local Herdr client at an SSH config host and stream the remote TUI back to your terminal.
$ herdr --remote workbox# responsive tui
Mobile-first when the terminal gets small.
Herdr stays usable over SSH from a phone or tablet. The terminal view remains real, while narrow screens get a switcher built for touch-sized decisions.
# the missing layer
Keep your terminal. Add the control surface.
Desktop agent terminals give you app UI. tmux gives you persistence. Herdr sits between them: a lightweight TUI process with real terminal panes, clickable layout, agent state, detach/reattach, remote attach, and an API your agents can drive.
Ghostty, Kitty, iTerm, Alacritty — your terminal stays.
No web view, no account, no hosted control plane.
Persistence plus clickable panes, agent state, an API.
# positioning
Most agent managers are apps. Herdr is a multiplexer.
tmux and Zellij own persistent terminal sessions but don't understand agents. Desktop agent apps understand agents but live on one machine. Herdr keeps the multiplexer in your terminal and makes it agent-aware. See the full comparison →
| Capability | tmux / Zellij | agent apps | worktree orchestrators | Herdr |
|---|---|---|---|---|
| Runs inside your terminal | ✓ | — | — | ✓ |
| Persistent PTY sessions | ✓ | limited | embedded | ✓ |
| Remote SSH attach | ✓ | limited | remote projects | ✓ |
| Semantic agent state | — | partial | workspace status | ✓ |
| Direct agent attach | — | — | — | ✓ |
| Agents can orchestrate it | scriptable | partial | workflow-owned | ✓ |
Runs inside your terminal
tmux/Zellij ✓ agent apps — worktree apps — Herdr ✓Persistent PTY sessions
tmux/Zellij ✓ agent apps limited worktree apps embedded Herdr ✓Remote SSH attach
tmux/Zellij ✓ agent apps limited worktree apps remote projects Herdr ✓Semantic agent state
tmux/Zellij — agent apps partial worktree apps workspace status Herdr ✓Direct agent attach
tmux/Zellij — agent apps — worktree apps — Herdr ✓Agents can orchestrate it
tmux/Zellij scriptable agent apps partial worktree apps workflow-owned Herdr ✓# your terminal
Same shell, same keybinds, real panes.
No rebuilt chat view. Real processes in real PTYs, with layout, clicks, state, and persistence added around them.
- Use the mouse for panes, tabs, workspaces, and menus.
- Keep your terminal fonts, shortcuts, SSH, and shell setup.
- Stay keyboard-first, or disable mouse input entirely.
~/Projects/herdr master
❯ just test
cargo nextest run
02:14:22 PASS app::state::tests
02:14:23 PASS platform::pty::tests
02:14:24 PASS protocol::wire::tests
3 passed · 0 failed · 0.8s
~/Projects/herdr master
❯
~/Projects/herdr master
❯ git status
On branch master
Your branch is up to date.
Changes not staged:
M src/app/state.rs
?? docs/next/
2 files changed, 14 insertions
# agents can drive it
The UI is also a control surface.
A CLI and JSON socket API expose workspaces, panes, output, and waits. Your agents can run their own workspace.
# create workspace structure
herdr workspace create --cwd ~/project --label api
herdr tab create --label logs
# split a pane and run work
herdr pane split 1-1 --direction right
herdr pane run 1-2 "just test"
# wait, inspect, and continue
herdr wait agent-status 1-1 --status done
herdr pane read 1-2 --source recent-unwrapped# agent awareness
Keep the herd in sight.
Workspace rollups
Each workspace rolls up to its most urgent agent state, so the whole session is scannable.
Agent list
See which agents are blocked, working, done, idle, or unknown without opening every pane.
blocked
working
done
idle
# integrations
Bring your existing agents into the herd.
Pi
Claude Code
Codex
Droid
Amp
OpenCode
Grok CLI
Hermes
Cursor
Antigravity
Kimi
Kiro
Copilot
Qoder CLI
Any terminal agent works out of the box. Integrations add richer state and session resume.
# start the herd
Install Herdr, run two agents, detach once.
The value shows up the first time the herd keeps running after your terminal disappears.
