# herdr plus

> herdr-plus supercharges herdr with quick actions and projects — an open-source extension platform for the herdr terminal. Free, by Cloudmanic Labs.

herdr-plus is an open-source add-on platform for herdr (https://herdr.dev), a terminal multiplexer and agent runtime. The same small binary runs in different *modes*; each mode adds a capability on top of herdr. Today it ships two: **Control** (the home base, whose first feature is **Projects** — declarative workspace templates) and **Quick Actions** (a fuzzy launcher that runs an action in a split pane). Configuration is plain TOML files under ~/.config/herdr-plus/. It is free and MIT-licensed, by Cloudmanic Labs, LLC.

## Documentation
- [Quick Start](https://herdrplus.com/docs/quick-start/): Go from zero to a working herdr-plus keybinding in four steps: install herdr, install herdr-plus, bind a key, press it.
- [Installation](https://herdrplus.com/docs/installation/): Install herdr-plus via Homebrew, the install.sh one-liner, or from source — with supported platforms, install locations, and upgrades.
- [Keybindings](https://herdrplus.com/docs/keybindings/): How herdr-plus install binds a herdr key to a mode: per-mode defaults, overriding the key, idempotency, and how to trigger an action.
- [Modes](https://herdrplus.com/docs/modes/): One herdr-plus binary, multiple modes. How --mode works, the available modes, and how to invoke each.
- [Control Mode & Projects](https://herdrplus.com/docs/projects/): Control mode opens a full-screen Herdr Plus workspace with the Projects browser — declarative templates that spin up a whole herdr workspace.
- [Quick Actions Mode](https://herdrplus.com/docs/quick-actions/): The fuzzy launcher: pick an action and run it in a split. Covers global actions and per-project actions shipped in a repo's .herdr-plus directory.
- [Actions Reference](https://herdrplus.com/docs/actions/): The complete action file format: the command, command/select/form types, separators and headings, and how the value is passed.
- [Template Variables](https://herdrplus.com/docs/variables/): Every context field an action's command can use, both as a Go template field and as a HERDR_PLUS_* environment variable.
- [Configuration](https://herdrplus.com/docs/configuration/): The herdr-plus config directory layout: projects/, quick-actions/, the file-per-entry model, per-repo overrides, and XDG_CONFIG_HOME.
- [Examples & Cookbook](https://herdrplus.com/docs/examples/): A copy-pasteable gallery of complete quick actions and project templates — commands, selects, forms, splits, and context variables.
- [Troubleshooting & FAQ](https://herdrplus.com/docs/troubleshooting/): Concrete fixes for the common herdr-plus issues: dead keybindings, command not found, key conflicts, config not loading, and template errors.

## Full text for agents
- [llms-full.txt](https://herdrplus.com/llms-full.txt): The complete documentation inlined as a single plain-text file.

## Project links
- [Documentation home](https://herdrplus.com/docs/): Human-readable docs.
- [GitHub repository](https://github.com/cloudmanic/herdr-plus): Source code, issues, releases.
- [Releases](https://github.com/cloudmanic/herdr-plus/releases): Versioned downloads and changelog.
- [herdr](https://herdr.dev): The terminal herdr-plus extends.
- [Cloudmanic Labs](https://cloudmanic.com): The maintainer.

## Install
- Homebrew: `brew tap cloudmanic/herdr-plus https://github.com/cloudmanic/herdr-plus` then `brew install cloudmanic/herdr-plus/herdr-plus`
- Script: `curl -fsSL https://raw.githubusercontent.com/cloudmanic/herdr-plus/main/install.sh | sh`
- Bind keys: `herdr-plus install` (Control → prefix+up) and `herdr-plus install --mode=quick-actions` (Quick Actions → prefix+down)