Quick Start · herdr plus

This is the fastest path from zero to a working herdr-plus keybinding. Four steps, a couple of minutes.

1. Make sure herdr is installed and running

herdr-plus is an add-on for herdr. You need a working herdr install first — follow the herdr install guide — and you need to be running inside a herdr session, because herdr-plus talks to the running herdr server over a local socket.

Note: herdr-plus only does something useful from inside herdr. If you run it outside herdr it can’t find a pane to work with.

2. Install herdr-plus

Pick whichever you prefer. Homebrew (the repo is its own tap):

brew tap cloudmanic/herdr-plus https://github.com/cloudmanic/herdr-plus
brew install cloudmanic/herdr-plus/herdr-plus

Install script (Linux/macOS, no Homebrew):

curl -fsSL https://raw.githubusercontent.com/cloudmanic/herdr-plus/main/install.sh | sh

See Installation for from-source builds, install-location overrides, and how upgrades work.

3. Install the keybindings

herdr-plus install wires herdr-plus into herdr’s config.toml as keybindings and reloads the running herdr server, so the bindings are live immediately. A bare install binds every mode at once, each on its own default key:

herdr-plus install                       # binds prefix+up -> control AND prefix+down -> quick-actions
herdr-plus install --mode=quick-actions  # bind just quick-actions (prefix+down)

Each mode claims its own default key, so the two coexist. Override a single mode’s key with --key=prefix+a. See Keybindings for the full story.

4. Press your prefix, then the key

In herdr, press your prefix (default ctrl+b) followed by the bound key:

prefix then up opens Control mode — a full-screen “Herdr Plus” workspace with the Projects browser.
prefix then down opens the Quick Actions launcher — a fuzzy finder in a split beneath your current pane.

That’s it. The first time you open Quick Actions, herdr-plus seeds your config with editable example actions so you have something to try right away.

Next steps

Control Mode & Projects — build workspace templates.
Quick Actions — the launcher and per-project actions.
Actions Reference — write your own actions.
Configuration — where everything lives on disk.