Quick start

Start Herdr from any project directory:

herdr

Herdr launches or attaches to your default background session. You do not manage sockets. If you detach, agents keep running.

For the local, SSH, and herdr --remote workflows, see How to work with Herdr.

Create a workspace

Press n to create a workspace. A workspace is a project-level container for tabs, panes, and agents.

Give each active project its own workspace. This keeps agent state readable in the sidebar.

Run an agent

Start your agent in the root pane.

pi

Herdr detects supported agents automatically. The sidebar shows whether each agent is working, blocked, done, or idle.

Keyboard control

Press ctrl+b to enter prefix mode, then press an action key.

Common actions:

Action	Key
Split right	prefix+v
Split down	prefix+minus
New tab	prefix+c
Next / previous tab	prefix+n / prefix+p
Workspace navigation	prefix+w
New workspace	prefix+shift+n
Detach client	prefix+q

After detaching, run herdr again to reattach to the same session.

Use the mouse

Herdr is mouse-native. You can click panes, tabs, workspaces, and agents; drag borders; select text; and use right-click menus.

Manage named sessions

Named sessions are separate Herdr server namespaces. Use them when you want fully separate runtime state.

herdr session list
herdr session attach work
herdr session attach side-project
herdr session stop work
herdr session delete side-project

Workspaces are usually enough. Use named sessions when you need isolation between sets of panes, sockets, and persistent state.

Attach from another machine

Run Herdr where the work lives. If the code and credentials are on a server, either SSH there and run Herdr like a terminal multiplexer:

ssh you@server
herdr

Or attach from your local terminal through SSH:

herdr --remote workbox
herdr --remote ssh://you@server:2222

For repeat targets, put the host in your SSH config. See How to work with Herdr for the full model.