Skip to main content
The banner shows the boxd and herdr logos with the line agents that keep running when you close your laptop. herdr is an open-source terminal workspace manager for coding agents. It runs Claude Code, Codex, and other agents in panes and shows which one needs you. With boxd, herdr runs on your laptop and the agents run on boxd machines. Each machine shows up in herdr’s sidebar next to your laptop, and its agents keep working when you close the lid.

​
Set up

1

Install the boxd CLI and sign in

2

Install herdr

3

Create a machine

When the CLI offers to connect, answer n. herdr connects in the next step, through the dev-box.boxd SSH name the CLI just set up.
4

Add the machine to herdr

herdr asks to install itself on the machine. Answer y. If it then warns that the remote shell does not resolve herdr, ignore it. The machine is saved and ready.
5

Open herdr

The sidebar shows Local and dev-box. Click ~ under dev-box, and the pane on the right becomes a shell on the machine.
6

Start an agent

In that pane, clone your repo and start Claude Code:
Pick Yes, I trust this folder. If Claude Code asks you to log in, do it once, and boxd reuses that login on your other private machines. With Git connected, git and gh work with your private repos too.
The agent shows up under agents in the sidebar with its state. Give it a task.

herdr machine add saves dev-box. herdr then shows it next to Local, with Claude Code working in both of its workspaces.

​
Run more agents

Press ctrl+b shift+n for another workspace on the same machine, or ctrl+b v to split the pane, and start another agent there. ctrl+b ? lists every keybinding. To add another machine, create it and add it the same way:

​
Close your laptop

The agents run on the machines, so they keep working after you quit herdr with ctrl+b q or close the lid. Run herdr again and every workspace is where you left it. An idle machine hibernates and wakes with its agents intact when herdr reconnects. While herdr is open, its connection keeps every machine in the sidebar awake. To let one sleep anyway, disable it. herdr machine list shows its profile ID in the first column:
herdr’s own docs cover the rest, including remote attach for one machine full screen and agent automation.