Skip to content

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.

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.

The marketplace adds discovery on top of installation; it does not replace it. Install any plugin straight from GitHub:

Terminal window
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.

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.

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.