Run on a server

Herdr is a server and a client. On a laptop both run locally, so the server lives as long as the laptop is awake. Move the server to a machine that never sleeps and the agents keep working after you close the lid.

Install on the server

Any Linux or macOS box with SSH access works. Windows cannot be the server yet. Install Herdr and the agents there, then log in to each agent once.

ssh workbox
curl -fsSL https://herdr.dev/install.sh | sh
herdr integration install claude
herdr integration install codex

Attach from the laptop

Two ways. The first works like tmux. SSH in and run herdr. Detach with prefix+q or drop the connection, and everything keeps running.

ssh workbox
herdr

The second runs the UI on the laptop and only the panes on the server. Your local config, keys, and mouse handling apply. This also works from a Windows laptop.

herdr --remote workbox

workbox is a host from your ~/.ssh/config. A full target like ssh://you@server:2222 works too.

Both at once

Herdr 0.9 and later can show a remote machine in the local sidebar, next to your local workspaces. Save it once and switch with a click. Not yet supported on Windows clients.

herdr machine add workbox --label "Build machine"

Details are in the connecting machines docs.

Check

Start an agent through herdr --remote, close the laptop, and reattach an hour later. The agent should be done, and the sidebar should show it in the done color.