Marketplace
Preview docs describe unreleased preview builds. Stable docs remain at /docs/.
The Herdr plugin marketplace is a discoverable index of community plugins. Browse it at herdr.chefgroep.nl/plugins. It is an automatic index of public GitHub repositories, not a reviewed catalog.
Browse plugins
Section titled “Browse plugins”The marketplace lists public repositories tagged with the GitHub
topic herdr-plugin when their default branch contains at least one
herdr-plugin.toml whose required metadata can be parsed. Search by repository
or plugin metadata, and sort repository cards by popularity, recent activity,
or newest. Each card links to its source repository and lists every discovered
plugin inside it.
Discovery is automatic and unreviewed. A listing means a repository tagged itself, not that Herdr vetted it, so the trust guidance applies before you install anything.
Install a plugin
Section titled “Install a plugin”The marketplace adds discovery on top of installation; it does not replace it. Install any plugin straight from GitHub:
herdr plugin install owner/repo[/subdir...]Publish a normal public GitHub repository with a herdr-plugin.toml manifest at
its root, or in a subdirectory, and that command works. See
Plugins for the manifest and authoring reference.
Get your plugin listed
Section titled “Get your plugin listed”Add the GitHub topic herdr-plugin to a public repository and put one or more
herdr-plugin.toml manifests with parseable required metadata on its default
branch. Manifests may be at the root or in subdirectories. The marketplace uses
one card per repository and lists each valid manifest as a separately
installable plugin. The index refreshes automatically every 30 minutes and
rescans repositories when their default-branch head changes.
What a listing shows
Section titled “What a listing shows”Each card shows GitHub repository metadata: the repository name and owner, its
description, star count, primary language, and the time it was last pushed. Its
plugin rows show each manifest’s name and version and link to the exact
source directory. The index records the manifest path, id, name, version,
platforms, and min_herdr_version together with the exact default-branch
commit. Forks, archived repositories, repositories without a valid plugin
manifest, and malformed manifest metadata are excluded.