# herdr

> Land in herdr instead of tmux, a terminal multiplexer that shows which of your coding agents is working, waiting on you, or done.

URL: https://prized.dev/docs/herdr

## Connect [#connect]

```bash
prized herdr
```

The first connect installs [herdr](https://github.com/herdrdev/herdr), an open-source terminal multiplexer built for coding agents, into `~/.local/bin` on the box (a checksum-verified release); 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.

| Command                         | What it does                                                |
| ------------------------------- | ----------------------------------------------------------- |
| `prized herdr my-box`           | Connect to another box.                                     |
| `prized herdr -s agents`        | Attach to, or create, a named herdr session.                |
| `prized herdr --no-forward`     | Leave the box's ports alone ([Ports](https://prized.dev/docs/ports)).         |
| `prized herdr --no-drop-upload` | Paste dragged files as plain paths, without uploading them. |
| `prized herdr --no-clipboard`   | Keep copies made on the box off this machine's clipboard.   |

## Find the agent that needs you [#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`.

| Keys                    | Action                           |
| ----------------------- | -------------------------------- |
| `ctrl+b c`              | New tab                          |
| `ctrl+b v` / `ctrl+b -` | Split right / down               |
| `ctrl+b h` `j` `k` `l`  | Move between panes               |
| `ctrl+b g`              | Jump to any agent                |
| `ctrl+b q`              | Detach; everything keeps running |
| `ctrl+b s` / `ctrl+b ?` | Settings / every key             |

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

## Works like `prized ssh` [#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; herdr shows the progress as a notification ([Sessions](https://prized.dev/docs/sessions#drag-files-in)).
* **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](https://prized.dev/docs/sessions#when-the-connection-drops)); a box paused meanwhile stays paused.

> herdr and tmux are separate: sessions started in one do not show in the other, and `prized ssh`, `prized mosh`, and the dashboard terminal still open tmux. The first install also writes herdr's config with notifications on; change it with `ctrl+b s`.

> If your shell startup starts tmux whenever `$TMUX` is empty, every herdr pane opens tmux. Skip it inside herdr by adding `[ -z "$HERDR_ENV" ]` to that check.