# herdr plus

> herdr-plus is a collection of tools that supercharge herdr — quick actions and projects for your terminal. Free and open-source, by Cloudmanic Labs.

herdr-plus is an open-source add-on for herdr (https://herdr.dev), a terminal multiplexer and agent runtime — built as a first-class herdr plugin (https://herdr.dev/docs/plugins/). Install it with `herdr plugin install cloudmanic/herdr-plus`; herdr clones the repo, builds it, and registers the plugin's actions. Two ship today: **Projects** (action `cloudmanic.herdr-plus.projects`) — declarative templates that spin up a whole herdr workspace of tabs and panes — and **Quick Actions** (action `cloudmanic.herdr-plus.quick-actions`) — a fuzzy launcher that runs a one-off action in the directory you launched from. Configuration is plain TOML files in herdr's managed plugin config directory. 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 plugin in four steps: install herdr, install the plugin, run an action, and optionally bind a key.
- [Installation](https://herdrplus.com/docs/installation/): Install herdr-plus as a herdr plugin with herdr plugin install — plus the optional standalone binary, supported platforms, and how upgrades work.
- [Keybindings](https://herdrplus.com/docs/keybindings/): Bind herdr keys to herdr-plus's plugin actions with [[keys.command]] entries (type = plugin_action), or just run them from herdr's action menu.
- [Projects](https://herdrplus.com/docs/projects/): Projects are declarative herdr workspace templates — pick one from a full-screen fuzzy browser and herdr-plus spins up a whole workspace of tabs and panes.
- [Quick Actions](https://herdrplus.com/docs/quick-actions/): The fuzzy launcher: pick an action and run it in the directory you launched from. Covers global actions and per-project actions shipped in a repo's .herdr-plus directory.
- [Worktree Auto-Layout](https://herdrplus.com/docs/worktrees/): Automatically lay a project-style tab layout into a git worktree the moment herdr creates or opens it, driven by the plugin's worktree.created and worktree.opened events.
- [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: herdr's managed plugin dir, the projects/, quick-actions/, and worktrees/ subdirs, the file-per-entry model, and per-repo overrides.
- [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 common herdr-plus issues: the plugin not registering, dead keybindings, config not loading, per-project actions, 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
- Plugin (this is the install): `herdr plugin install cloudmanic/herdr-plus` — herdr clones, builds, and registers it; re-run the same command to upgrade in place. Requires herdr >= 0.7.0.
- Config dir (holds projects/ and quick-actions/): `herdr plugin config-dir cloudmanic.herdr-plus`
- Bind keys (optional — or run the actions from herdr's action menu): add `[[keys.command]]` entries to herdr's config.toml with `type = "plugin_action"` and `command = "cloudmanic.herdr-plus.projects"` / `"cloudmanic.herdr-plus.quick-actions"`, then run `herdr server reload-config`.
- Optional standalone binary (only to get `herdr-plus` on your PATH; does NOT register the plugin): `brew tap cloudmanic/herdr-plus https://github.com/cloudmanic/herdr-plus` then `brew install cloudmanic/herdr-plus/herdr-plus`, or `curl -fsSL https://raw.githubusercontent.com/cloudmanic/herdr-plus/main/install.sh | sh`.