Skip to content

Herdr documentation

Install, learn, and configure Herdr. Start on the path that matches you — no multiplexer experience required.

New to terminal multiplexers?

You don’t need to learn shortcuts to start. Herdr is mouse-first: click panes, drag borders, split and switch from right-click menus.

Quick start →

Coming from tmux or zellij?

You already know the model. The prefix is ctrl+b, panes persist, detach and reattach work the way you expect.

Concepts → · Keybindings →

Already running an AI coding agent? Let it do the onboarding. Paste this prompt:

Help me understand and set up Herdr. Read https://herdr.dev/agent-guide.md first, then walk me through it step by step.

The guide teaches your agent Herdr’s concepts, setup, configuration, and common fixes, so its answers stay accurate instead of improvised.

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 →

Plugins

Author local executable workflow plugins with manifest actions and event hooks.

Write a plugin →

Marketplace

Share plugins from GitHub today and tag your repo to be listed when the marketplace launches.

Publish a plugin →