1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
---
title: Quick start
description: Create your first Herdr workspace and run agents in persistent terminal panes.
---
Start Herdr from any project directory:
```bash
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](/docs/how-to-work/).
## 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.
```bash
pi
```
Herdr detects supported agents automatically. The sidebar shows whether each agent is `working`, `blocked`, `done`, or `idle`.
## Navigate
Press `ctrl+b` to enter navigate mode.
Common actions:
| Action | Key |
| --- | --- |
| Split right | `v` |
| Split down | `-` |
| New tab | `c` |
| New workspace | `n` |
| Detach client | `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.
```bash
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:
```bash
ssh you@server
herdr
```
Or attach from your local terminal through SSH:
```bash
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](/docs/how-to-work/) for the full model.
|
