Skip to content
herdr herdr

Herdr documentation

One terminal for the whole herd: real panes, persistent sessions, SSH attach, state awareness, and CLI/socket orchestration.
Install Herdr Quick start

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.

Terminal window
curl -fsSL https://herdr.dev/install.sh | sh
herdr

Start here

Section titled “Start here”

Install

Install Herdr on Linux or macOS, update it later, and verify the binary.

Install Herdr →

Quick start

Create your first workspace, run an agent, split panes, and detach safely.

Start using Herdr →

Local, SSH, and mobile

Run Herdr locally, inside SSH, from your phone, or through herdr --remote.

Pick a workflow →

Agents

See supported agents, detection behavior, integrations, custom labels, and direct attach.

Understand agents →

Configuration

Configure keybindings, themes, sidebar behavior, notifications, scrollback, and advanced options.

Configure Herdr →

API

Control Herdr from scripts, tools, and agents through the CLI and local socket API.

Read the API guide →