Using Herdr Effectively

Remote Work and Restore

Choose the right attachment path and know what survives

Choose your path

Situation	Command	Where work runs
Local project	`herdr`	Your local machine
Already inside remote SSH	`ssh you@server` `herdr`	The remote server
Local-feeling remote UI	`herdr --remote workbox`	The remote server
One terminal only	`herdr agent attach reviewer`	The Herdr server

Persistence matrix

Event	Processes	Layout	Agent conversation
Detach / reattach	Keep running	Returns	Continues
Server restart	Stop	Restores	Only with native restore
Update with handoff	Best effort	Returns	Continues if handoff succeeds

Commands

# Detach without stopping work
Ctrl+B, then Q

# Reattach
herdr

# Named sessions
herdr session list
herdr session attach work
herdr session stop work
herdr session delete side-project

# Remote thin client
herdr --remote workbox
herdr --remote workbox --session agents

# Optional experimental handoff
herdr update --handoff
herdr --remote workbox --handoff

Important boundary

Snapshot restore reconstructs the layout, not ordinary running processes. A restored shell is not the same shell that was running before the server stopped.