herdrlisted

# Driving herdr `herdr` is a terminal workspace manager for AI coding agents. It runs a background server and exposes everything over a CLI that talks to that server's socket. This skill covers reading and changing the layout, and driving other agents. ## The object model (read this first) ``` session (a named background server, own socket, own workspace tree) └── workspace ← the per-project / per-worktree unit. HAS THE LABEL in the sidebar. └── tab ← a tab within a workspace └── pane ← a terminal within a tab; where a shell or agent runs └── agent ← an AI agent (e.g. claude) attached to a pane ``` **The trap:** "rename **this session**", "what session am I in", "close that session" usually mean the **workspace** - the labeled sidebar item. Map "session" → workspace by default. But sessions are real and plural. A session is a separate server with its own socket and its own workspaces; users routinely run one per project, and `default` is often **stopped** while the work lives in named sessions. Every command here talks to *one* session - the one your pane is in. Workspace `w1` in `neochain` and `w1` in `personal` are different workspaces. Run `herdr session list` before assuming. | Object | id example | rename command | |-----------|----------------|---------------------------------------| | workspace | `w1` | `herdr workspace rename <id> <label>` | | tab | `w1:t1X` | `herdr