Documentation

herdr-plus is an add-on platform for herdr — a place to build extensions and plugins on top of herdr’s terminal panes. It is free and open source, built by Cloudmanic Labs.

The mental model

herdr-plus ships as a single binary. The same binary can run in different modes, and each mode decides what to do when it talks to herdr. You bind a mode to a herdr keybinding, press your prefix plus that key, and the mode springs to life inside herdr.

We’re in explore mode: the list of modes will grow over time. Today there are two.

Modes

Pick a mode with --mode=<slug>. With no flag, the default mode (control) runs.

Each mode has its own default key, so the two can be installed side by side.

Where to start

• Quick Start — the fastest path from zero to a working keybinding.
• Installation — every install method (Homebrew, install script, from source) and how upgrades work.
• Control Mode & Projects — declarative workspace templates that spin up a whole herdr workspace of tabs and panes.
• Quick Actions — the fuzzy launcher and per-project actions.

If you just want the reference, jump to Keybindings, Modes, the Actions Reference, Template Variables, Configuration, the Examples & Cookbook, or Troubleshooting.