Herdr Docs

Workflow: Remote Development ​

Fresh

Run Herdr where the work lives. Attach from wherever you are: desktop, laptop, or phone.

flowchart LR
    S[Server: Herdr + agents + code] --- A[Desktop: herdr --remote]
    S --- B[Laptop: ssh + herdr]
    S --- C[Phone: SSH client + herdr]

Pick your attach path ​

PathCommandBest for
SSH then Herdrssh you@server then herdrLiving in an SSH shell, phone/tablet clients, simplest setup
Thin clientherdr --remote workboxRemote session that feels local, with local clipboard image paste bridged
Local onlyherdrWork on this machine

The difference that matters: with herdr --remote, the client runs on your machine, so local desktop features such as image clipboard paste can be bridged to the remote server. If you SSH first and run herdr on the server, Herdr runs entirely there and cannot read your local desktop clipboard.

Day-to-day loop ​

  1. Morning, from the desktop:
herdr --remote workbox

  1. Start agents, kick off builds, split panes. Everything runs on the server.

  2. Detach (ctrl+b q) and leave. Agents keep working.

  3. From your phone later: install any SSH client (on iPhone, moshi works well), connect, and run:

ssh you@server
herdr

The same persistent session opens. The TUI adapts to narrow screens, so you can inspect agents, switch workspaces, and check panes without leaving SSH.

  1. Back at the desk, herdr --remote workbox again. Same session, same panes.

Isolation with named sessions ​

Use named remote sessions when you want fully separate runtime state per context:

herdr --remote workbox --session agents
herdr --remote workbox --session client-work

A named session has its own panes, tabs, workspaces, sockets, and runtime state, sharing only the global config file.

Survive restarts ​

  • Normal detach: everything keeps running (strongest path).
  • Server restart: layout restores; pane processes do not. Enable native agent session restore (on by default) so supported agents resume their conversations, and optionally [experimental] pane_history = true to replay recent pane contents.
  • Updates: herdr update --handoff and herdr --remote workbox --handoff opt into experimental live handoff that keeps pane processes alive across a server replacement.

See Session State and Restore for the full survival matrix.