Herdr preview documentation

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

Install Herdr Quick start

Preview docs describe unreleased preview builds. Stable docs remain at /docs/.

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.

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

On Windows preview beta:

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
herdr

Start here

Install

Install stable Herdr on Linux/macOS or the Windows preview beta, 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 →

Session state

Understand detach, restart restore, pane history replay, native agent resume, and live handoff.

Compare state paths →

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 →