Skip to content

Start Here

Fresh

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.

Install in one line

Linux or macOS:

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

herdr

Windows preview beta:

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

herdr

Section contents

PageWhat it covers
Install HerdrStable install on Linux/macOS, Windows preview beta, Homebrew, mise, Nix, manual downloads, updates, and channels
Windows BetaWhat works, what is partial, and what is unsupported in the native Windows beta
Quick StartFirst workspace, running an agent, keyboard control, mouse, copy mode, named sessions
How to Work with HerdrLocal work, SSH, phone access, and the herdr --remote thin client
ConceptsWorkspace, tab, pane, agent, session, client/server, modes, and mouse UI

The core idea

Herdr is a background session server plus one or more terminal clients. Panes keep running in the server. Clients attach, detach, and render the session. Run several coding agents in parallel, and the sidebar tells you which one is working, which one is blocked on a decision, and which one is done and ready for review.