This directory contains the official Matcha plugin collection and the plugin registry that powers the marketplace.

Browse and install plugins interactively:

matcha marketplace

Use j/k or arrow keys to navigate, Enter to install, and q to quit. You can also access the marketplace from Matcha's main menu.

matcha install https://raw.githubusercontent.com/floatpane/matcha/master/plugins/hello.lua

matcha install path/to/my_plugin.lua

curl -sL https://raw.githubusercontent.com/floatpane/matcha/master/plugins/hello.lua \
  -o ~/.config/matcha/plugins/hello.lua

Plugins are installed to ~/.config/matcha/plugins/ and loaded automatically on next startup.

Open a plugin file in your editor to configure it:

matcha config hello          # opens ~/.config/matcha/plugins/hello.lua in $EDITOR
matcha config                # opens ~/.config/matcha/config.json in $EDITOR

Anyone can add their plugin to the marketplace by submitting a PR to this repository.

1. Write your plugin as a .lua file following the Plugin API docs.

2. Add an entry to registry.json in this directory:

   {
     "name": "my_plugin",
     "title": "My Plugin",
     "description": "A short description of what your plugin does.",
     "file": "my_plugin.lua",
     "url": "https://raw.githubusercontent.com/YOUR_USER/YOUR_REPO/main/my_plugin.lua"
   }

3. Submit a pull request to floatpane/matcha.

• Keep plugins focused — one plugin, one purpose.
• Include a comment header in your .lua file with a description:

  -- my_plugin.lua
  -- A short description of what this plugin does.

• Test your plugin with the latest version of Matcha before submitting.
• Do not include external dependencies — plugins run in a sandboxed Lua environment.
• The url field should point to a raw file URL that stays stable (use a tagged release or main branch).

Visit the Plugin Marketplace on the Matcha documentation site to browse all available plugins with one-line install commands.