Skip to content
These pages describe the newest preview build. For the current release, read the stable documentation.
herdsmanherdsman

A terminal workspace for coding agents

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

herdsman: a repository’s worktrees sorted into sections in the sidebar, and an editor beside a stack of three agent panes

New to terminal multiplexers?

You don’t need to learn shortcuts to start. Herdsman 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 →

If you already run an AI coding agent, let it handle the onboarding. Paste this prompt:

Help me understand and set up Herdsman. Read https://remziduzagac.github.io/herdsman/agent-guide.md first, then walk me through it step by step.

The guide covers Herdsman’s concepts, setup, configuration, and common fixes, so your agent can answer from the docs instead of improvising.

Agents

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

Understand agents →

Connecting machines

Keep Local and saved SSH machines in one window, with a combined agent list and independent reconnects.

Connect your machines →

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 Herdsman →

API

Control Herdsman 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 →

Stacked panes

Keep several panes in one slot and show one at a time, while the hidden ones keep running.

Stacks →

What herdsman adds

Every feature herdsman has on top of herdr, with the release it arrived in.

What herdsman adds →