---
title: Marketplace
description: Discover community Herdr plugins on GitHub, and get your own plugin listed.
---

The Herdr plugin marketplace indexes community plugins. Browse it at
[herdr.dev/plugins](/plugins/). The index covers public GitHub repositories; it
is not a reviewed catalog.

## Browse plugins

The [marketplace](/plugins/) 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](/docs/plugins/#trust-and-security) applies before you install
anything.

## Install a plugin

The marketplace helps you discover plugins. Install any plugin straight from
GitHub:

```bash
herdr plugin install owner/repo[/subdir...]
```

The command works with a public GitHub repository that has a
`herdr-plugin.toml` manifest at its root or in a subdirectory. See
[Plugins](/docs/plugins/) for the manifest and authoring reference.

## 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

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.
