Plugin Registry

The SemRels Plugin Registry is the public catalog for semrel plugins. It brings together plugin metadata, released versions, download URLs, and checksums so semrel can discover and install plugins consistently.

Browse Plugins

Explore all available plugins, filter by category, and read version history at registry.semrel.io.

Submit a Plugin

Community plugins can be submitted for review at registry.semrel.io/submit.

The machine-readable registry index is served at:

Web UI: https://registry.semrel.io
REST API: https://registry.semrel.io/api/v1/plugins
Raw index: https://semrels.github.io/semrel-registry/plugins.json
Source: SemRels/semrel-registry

What the registry does

Discovery

Helps users find plugins by name, category, author, repository, or tags.

Delivery

Points semrel to the correct release asset for the current operating system and CPU architecture.

Integrity

Publishes SHA-256 checksums so downloaded binaries can be verified before use.

How to use the registry

You can interact with the registry directly from the CLI:

semrel plugin search github
semrel plugin install github

semrel consumes the registry as structured metadata. When a plugin is not already available locally, semrel can fetch the registry index, resolve a compatible release, download the binary, verify its checksum, and install it into ~/.semrel/plugins/.

Metadata schema overview

The registry payload starts with a small root document and then lists plugins with one or more published versions.

Field	Purpose
`schemaVersion`	Version of the top-level registry payload
`generatedAt`	Timestamp written when the index is generated
`plugins`	Array of plugin records
`plugins[].name`	Stable plugin identifier used by semrel
`plugins[].category`	High-level plugin type
`plugins[].repository`	Source repository URL
`plugins[].versions[].version`	Released plugin version
`plugins[].versions[].downloadUrl`	Direct binary download URL
`plugins[].versions[].checksums`	SHA-256 checksums keyed by platform such as `linux_amd64`
`plugins[].versions[].compatibility`	Optional minimum semrel compatibility hints

{
  "schemaVersion": 1,
  "generatedAt": "2026-05-24T12:00:00Z",
  "plugins": [
    {
      "name": "github",
      "description": "GitHub provider plugin for semrel",
      "author": "SemRels",
      "license": "Apache-2.0",
      "category": "provider",
      "repository": "https://github.com/SemRels/provider-github",
      "tags": ["github", "provider"],
      "versions": [
        {
          "version": "1.2.3",
          "releaseDate": "2026-05-24T12:00:00Z",
          "downloadUrl": "https://github.com/SemRels/provider-github/releases/download/v1.2.3/semrel-plugin-github_linux_amd64.tar.gz",
          "checksums": {
            "linux_amd64": "<sha256>",
            "windows_amd64": "<sha256>"
          },
          "compatibility": {
            "minSemrelVersion": "0.2.0"
          }
        }
      ]
    }
  ]
}

Publishing a plugin

If you maintain a plugin, continue with the Plugin Publishing Guide for the release flow, naming recommendations, and checksum steps.

Community authors can also submit plugins directly through the registry submission form — a maintainer will review and approve submissions against our standards.

Plugin Registry

What the registry does

How to use the registry

Metadata schema overview

Publishing a plugin

Related docs