page 2: beyond "detach and reattach".
| Ctrl-b v | split pane right |
| Ctrl-b - | split pane down |
| Ctrl-b c | new tab |
| right-click | split, close, everything else via menu |
| drag border | resize panes with the mouse |
a workspace is the project-level container — one per repo, task, or investigation. it owns its own tabs and panes, and the sidebar rolls agent states up per workspace. run three projects with three agents each and still see, in one glance, where you're needed.
# way 1: like tmux — run herdr ON the server ssh user@server herdr # detach-safe, exactly like the tmux workflow # way 2: thin local client attached to a remote server herdr --remote server # local UI + config, remote processes
herdr agent list # what herdr sees right now herdr agent explain <target> --json # why a pane was classified that way herdr integration install claude # authoritative state instead of screen heuristics herdr integration status # what's installed
herdr has a CLI + local socket API, so an agent inside a pane can split panes, launch helper agents, run commands without stealing focus, and read their output. there's a ready-made skill:
npx skills add herdrdev/herdr --skill herdr -g
docs: herdr.dev/docs/cli-reference and /docs/socket-api
herdr session attach work # a fully separate runtime namespace # most people only ever need the default session
| ~/.config/herdr/config.toml | config (works fine without one) |
| herdr --default-config | print full default config |
| herdr server reload-config | apply edits to a running server |
| herdr status | runtime summary |
| ~/.config/herdr/herdr.log | logs when something looks wrong |
| herdr server stop | stop everything |
the prefix and every binding are configurable under [keys]; Ctrl-b ? always shows what's live.