herdr

Connect

prized herdr

The first connect installs herdr, an open-source terminal multiplexer built for coding agents, into ~/.local/bin on the box: a checksum-verified release of about 30 MB, with a progress bar, usually done in a second or two. Later connects reuse it, and a herdr you installed yourself is used as is. You land in herdr's default session, the same one herdr opens from any shell on the box, and a suspended box wakes first.

The first time, herdr shows a one-screen welcome; press Enter. Its settings then open on agent integrations: installing the ones for Claude Code and Codex makes their states exact. Press Esc to skip. When you detach, prized herdr confirms that herdr and your agents are still running.

Find the agent that needs you

The sidebar lists every agent with its state: working, blocked (waiting on you), idle, or done. Press ctrl+b g to list them all, then b for the blocked ones and Enter to jump there. Start an agent in a new tab with ctrl+b c, then claude or codex.

When an agent finishes, or is blocked waiting on you, you get a notification on your computer, like any app's. herdr skips it while you're looking at that agent.

• Ghostty, iTerm2, WezTerm and kitty show it themselves. prized herdr tells herdr which terminal you're in, since ssh doesn't. Your terminal may hold it back while its window is in front.
• Any other terminal (Terminal.app, VS Code's, or one inside a local tmux) gets it from prized, through macOS's notifications or notify-send on Linux. Without either, the terminal's bell rings.

On a Mac, if no notifications appear, allow them for your terminal, or for Script Editor (which posts prized's), in System Settings › Notifications. Drag-and-drop progress arrives the same way.

The mouse works too: click tabs and agents, drag pane borders, right-click for menus.

Works like prized ssh

On macOS and Linux:

• Drag files in. Files dropped on the window upload to ~/.prized/drops/ and paste as box paths; the progress arrives as a notification (Sessions).
• Copy out. A copy made on the box, Claude Code's included, lands on this machine's clipboard.
• Dropped connections reconnect to the same herdr session (Sessions); a box paused meanwhile stays paused.

From the dashboard and your phone

Once a box has herdr, its Terminal tab shows tmux and herdr at the top right. Pick herdr to land in herdr's default session, the one prized herdr opens, so the agents you run there are a tap away on your phone.

• Narrow screens: herdr folds its sidebar into a bar at the top.
• Toasts: when an agent finishes or needs you, a toast shows over the terminal. Very large notification messages are ignored to keep the terminal responsive.
• Taps and drags: taps reach herdr as clicks without raising the keyboard, and a drag scrolls the agent in front of you.
• Typing: tap Claude Code's prompt, or the keyboard key under the terminal; ctrl there, then b and a key, gives herdr's ctrl+b keys (ctrl, b, c opens a new tab).
• The choice sticks: the browser remembers it for each box, and ?mux=herdr in the tab's address picks it directly.

Your laptop and phone can show the same herdr at once. Each screen's view fits the tab it is on; when both are on the same tab, the screen you last tapped, clicked, or typed in sets that tab's size. After you use the phone, the laptop shows phone-sized panes in that tab until you click back into it.