An extension platform for herdr

Supercharge herdr.

Quick actions in any tab. Whole workspaces from one file. An open-source extension platform for the herdr terminal.

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

Open source · Free forever · macOS & Linux · no Electron

herdr plus — product tour
Watch herdr-plus spin up a whole workspace and launch actions without leaving your terminal.

New here? Start with this

It’s a plugin layer for your terminal.

herdr is a terminal multiplexer and agent runtime — tmux-style panes, persistent sessions, and an API that agents can drive. herdr-plus is the open-source extension platform that sits on top of it.

One small binary, installed as a herdr keybinding. Two features today — Quick Actions and Projects — with a plugin-style modes system designed to grow. Everything is driven by plain TOML files you own.

More modes soon

A plugin system that keeps growing.

+ Projects

Whole workspaces from one file.

+ Quick Actions

A fuzzy launcher in any tab.

herdr

The terminal underneath it all.

prefix + down — quick actions
The herdr-plus Quick Actions launcher: a fuzzy picker listing Project actions (make build, make test) above Global actions (Open GitHub PR, Open GitHub Project, Open Project Board).

Quick Actions

A fuzzy launcher in any tab.

Hit prefix and a focused split opens beneath your pane. Fuzzy-find an action, press enter, and it runs — then the split closes itself. Your hands never leave the keyboard.

  • Three action types — run a command, pick from a select list, or type into a form.
  • Per-project actions — drop a .herdr-plus/ folder in a repo and its actions appear, grouped, only there.
  • Context-aware — commands are Go templates with {{.WorkDir}}, {{.Value}}, and more, also exported as HERDR_PLUS_* env vars.
  • Just files — one TOML per action in ~/.config/herdr-plus/. Add a file, get an action.
Quick Actions docs

Projects

Whole workspaces from one file.

Hit prefix , pick a project, and herdr-plus builds the entire workspace — every tab created, every split laid out, every startup command running. It replaces hand-written workspace shell scripts with a config file you can read at a glance.

  • Declarative tabs — a name, a working directory, and an ordered list of tabs with startup commands.
  • Split panes — up to four panes per tab, stacked down or side-by-side right.
  • Paths that expand~ and $VARS resolve in working_dir.
  • Group by client — tag projects with a group and the browser clusters them under headings; the rest fall under Ungrouped.
  • One file per project — kept in ~/.config/herdr-plus/projects/. Versionable, shareable, yours.
Projects docs
prefix + up — projects
The herdr-plus Projects browser showing 21 projects grouped by client — King's Loot, Options Cafe, and Remote SQLite — with the remaining projects under an Ungrouped heading.

Built the way terminal people like it

Small, fast, and entirely yours.

Plain TOML, no UI

Every action and project is a file you can read, edit, version, and share. No databases, no dashboards.

Keyboard-native

Bound to your herdr prefix. Fuzzy-find, run, done — the launcher closes itself when the action fires.

A modes system

One binary, many modes. Control and Quick Actions today; the plugin surface is designed to grow.

Per-repo extensions

Ship a .herdr-plus/ folder with a repo and its actions show up — grouped and scoped — only inside it.

Idempotent install

herdr-plus install wires the keybinding and reloads herdr. It won’t duplicate or clobber an existing binding.

Free & open source

MIT-licensed, no telemetry, no lock-in. Auto-updates via Homebrew or the install script on every release.

Get started

Up and running in under a minute.

You’ll need herdr installed first. Then:

1

Install the binary

Homebrew or a one-line script — your pick.

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

Bind the keys

Wire the keybindings into herdr (it reloads automatically).

$ herdr-plus install
$ herdr-plus install --mode=quick-actions

Control → prefix · Quick Actions → prefix

3

Press the key

Inside herdr, hit your prefix and the bound key:

ctrl+bthen→ Projects
ctrl+bthen→ Quick Actions
Full quick start

Everything is documented.

Quick starts, every config field, the full action and project schemas, template variables, a copy-paste cookbook, and troubleshooting. Read it top to bottom and you’ll know the whole product.

Built for agents, too.

Point an LLM or coding agent at /llms.txt for a structured index, or /llms-full.txt for the entire docs in one plain-text fetch.

$ curl -s https://herdrplus.com/llms-full.txt