Skip to content

About

Open directory of publicly installable Buzz plugins

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Buzz Plugins

An open directory of Buzz plugins that anyone can install from a public Git repository.

Plugin source stays in its author's repository. The directory lists a plugin once its source is publicly fetchable without credentials and audits each pinned commit. GitHub Actions publishes the result as a static index.json:

https://raw.githubusercontent.com/block/buzz-plugins/index/index.json

Parts

Path What it is
indexer/ Crawls sources, checks they're public, audits access, builds index.json, and checks proposed sources
.github/ The workflows that publish the index and check new sources, and the list-a-plugin issue form
marketplace/ The Community Marketplace Buzz plugin that browses the index
template/ A starter plugin for authors
SPEC.md The contract: listing keys, publicity check, audit, index.json, publishing

Listing a plugin

  1. Start from template/, a minimal plugin with a build script and an example buzz-listing.yaml, or bring your own.

  2. Commit a built manifest.json and plugin.js to a public GitHub repository, at the root or in a subfolder, on a branch or tag.

  3. Optionally add buzz-listing.yaml next to the manifest with a tagline, description, category, tags, demo media, setup steps and links.

  4. Add one line to sources.txt in a pull request:

    https://github.com/<owner>/<repo> <branch or tag> [folder]
    

    Or open the List a plugin issue form and a maintainer adds it. Add your plugin in the Community Marketplace checks your repository first and opens either one with the line filled in.

  5. A check runs on the pull request or issue and comments with the result. Once a maintainer merges, the listing appears after the next index publish, within a few minutes.

Maintainers can also run pnpm run add owner/repo [ref] [path], which runs the same check and appends the line to sources.txt.

Every listing is labelled as unreviewed community content. Buzz's own install review, which shows the requested access and the exact commit, is still the gate before anything runs.

Privacy

The directory collects nothing about who installs a plugin. The index is a static file, and the marketplace plugin only reads it and GitHub's public API.

Development

Requires Node 24 and pnpm.

pnpm install
pnpm test
pnpm crawl                 # writes .data/index.json and .data/crawl-report.json
cd marketplace && pnpm install && pnpm check
cd ../template && pnpm install && pnpm build

Project resources

Resource Description
CODEOWNERS Project leads
GOVERNANCE.md Project governance
LICENSE Apache License, Version 2.0

About

Open directory of publicly installable Buzz plugins

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages