herdr 워크스페이스 설정, 에이전트를 여러 개 나란히 두려면
A herdr workspace groups the tabs and panes for one project or task, letting you run several agents side by side in one place. This overview covers only what the official herdr documentation states as of 2026-09-16.
When Should You Create a New Workspace?
Short answer: Create a new workspace when you start work on a specific repository, task, or investigation.
A workspace is the top-level container for a given repository, task, or investigation. Starting an empty session automatically opens a workspace.
The official best practice is one workspace per active project. Creating a workspace also creates its first tab and root pane.
A workspace owns its tabs, and a tab defines the pane layout inside it.
How Do You Run an Agent in a Pane?
Short answer: Starting an agent requires an existing shell pane; the start itself does not create or rearrange the layout.
Running a supported coding agent — claude, codex, pi, or opencode — in a real terminal pane is auto-detected.
The sidebar then rolls the detected agent’s state up into one of five states: blocked, working, done, idle, or unknown.
To split panes, use the default prefix ctrl+b together with prefix+v for a pane to the right or prefix+minus for a pane below.
Do Tasks Continue After Detaching?
Short answer: The server owns the panes; the client is only a UI on top of it.
Pressing ctrl+b q detaches the client, but the server and its agents keep running.
Reattaching only requires typing herdr again.
Running herdr server stop ends the session and its panes. After a full server stop, the next start restores the saved session shape.
FAQ
Short answer: The table below covers mouse and keyboard use, workspace shortcuts, and how workspaces differ from sessions.
| Question | Answer |
|---|---|
| Is the keyboard required? | No. herdr is mouse-native: click, drag to split, and right-click menus cover most actions, and keyboard use is optional. |
| How do you create a new workspace? | Use prefix+shift+n. |
| How do you rename a workspace? | Use prefix+shift+w. |
| How do you close a workspace? | Use prefix+shift+d. |
| How do workspaces differ from sessions? | Use workspaces first; reach for a named session only when you need fully separate panes, sockets, or runtimes. |
Sources
Short answer: This article is grounded only in the official herdr documentation listed below, as of 2026-09-16.