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

The Herdr plugin marketplace is a discoverable index of community plugins.
Browse it at [herdr.dev/plugins](/plugins/). It is an automatic index of public
GitHub repositories, not a reviewed catalog.

## Browse plugins

The [marketplace](/plugins/) lists every public repository tagged with the
GitHub topic `herdr-plugin`. Search by name, owner, description, or language,
and sort by popularity, recent activity, or newest. Each listing links straight
to its source repository on GitHub.

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 adds discovery on top of installation; it does not replace it.
Install any plugin straight from GitHub:

```bash
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](/docs/plugins/) for the manifest and authoring reference.

## Get your plugin listed

Add the GitHub topic `herdr-plugin` to a public repository. That topic is the
only signal the index uses, so tagging a public plugin is all it takes. The
index refreshes automatically every 30 minutes, so a newly tagged repository
shows up shortly after, and one that drops the topic disappears on the next
refresh.

## 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, with
a link back to the source. The index reads this from GitHub's repository search,
so keeping your repository description and topics accurate is what makes your
listing useful.

The index does not parse `herdr-plugin.toml` yet, so manifest fields like the
plugin `id`, declared `platforms`, and `min_herdr_version` are not shown in v1.
Forks and archived repositories are excluded from the list.
