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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
---
title: Herdr documentation
description: Terminal-native agent runtime and multiplexer.
template: splash
hero:
tagline: "One terminal for the whole herd: real panes, persistent sessions, SSH attach, state awareness, and CLI/socket orchestration."
image:
file: ../../../public/assets/logo.svg
actions:
- text: Install Herdr
link: /docs/install/
- text: Quick start
link: /docs/quick-start/
variant: secondary
---
import { Card, CardGrid } from '@astrojs/starlight/components';
Herdr is a terminal-native agent runtime and multiplexer. It gives the whole herd persistent terminal workspaces with panes, tabs, mouse control, state awareness, and an API that agents can use themselves.
```bash
curl -fsSL https://herdr.dev/install.sh | sh
herdr
```
## Core runtime
<CardGrid>
<Card title="Detach and reattach">
Herdr runs panes in a background session server, so agents keep running after the UI client detaches.
[Use persistence →](/docs/persistence-remote/)
</Card>
<Card title="Attach over SSH">
Run Herdr where the code and credentials live. Attach from any SSH client or use `herdr --remote` from your local terminal.
[Use remote access →](/docs/persistence-remote/#remote-attach-over-ssh)
</Card>
<Card title="Real terminal panes">
Every pane is a real terminal. Split layouts, click panes, drag borders, select text, and use right-click menus.
[Learn concepts →](/docs/concepts/)
</Card>
<Card title="Runtime API">
See agent status in the sidebar and drive workspaces, tabs, panes, waits, and output reads through the CLI or socket API.
[Read the API guide →](/docs/socket-api/)
</Card>
</CardGrid>
## Start here
<CardGrid>
<Card title="Install">
Install Herdr on Linux or macOS, update it later, and verify the binary.
[Install Herdr →](/docs/install/)
</Card>
<Card title="Quick start">
Create your first workspace, run agents in panes, split the layout, and detach safely.
[Start using Herdr →](/docs/quick-start/)
</Card>
<Card title="Concepts">
Understand workspaces, tabs, panes, agents, sessions, modes, and state rollups.
[Learn the model →](/docs/concepts/)
</Card>
</CardGrid>
## Guides and reference
<CardGrid>
<Card title="Agents">
See supported agents, detection behavior, integrations, custom labels, and direct attach.
[Understand agents →](/docs/agents/)
</Card>
<Card title="Configuration">
Configure keybindings, themes, sidebar behavior, notifications, scrollback, and advanced options.
[Configure Herdr →](/docs/configuration/)
</Card>
<Card title="Integrations">
Install agent integrations for Pi, Claude Code, Codex, and OpenCode.
[Set up integrations →](/docs/integrations/)
</Card>
<Card title="CLI reference">
Use every Herdr command for sessions, workspaces, tabs, panes, agents, waits, and integrations.
[Browse commands →](/docs/cli-reference/)
</Card>
<Card title="Socket API">
Control Herdr from scripts, tools, and agents through the local socket API.
[Read the API guide →](/docs/socket-api/)
</Card>
<Card title="Agent skill">
Teach an agent running inside Herdr how to create panes, read output, and wait for neighboring agents.
[Use the skill →](/docs/agent-skill/)
</Card>
</CardGrid>
|
