Plugins

Extensions add new commands and tools to QuickPeach. Once installed, they show up in the launcher alongside built-in commands — you use them exactly the same way.

Install an extension

1. Press ⌥ ⇧ Space and type @ext (or @store) to open the Store.
2. Browse or search for the extension you want.
3. Press Enter to install it.

The extension is available immediately — no restart needed.

Use an extension

After install, the extension's commands appear in the launcher when you search. Type the command name or a keyword it responds to, and press Enter to run it.

Some extensions add a launcher prefix so you can scope directly to them. Check the extension's description to see if it has one.

Extension preferences

Extensions that have settings show their options in Settings → Extension Preferences. Scroll down to find the extension by name and change its settings there.

Uninstall

Open the Store (@ext), find the extension, and select Uninstall. The extension and its data are removed.

What extensions can do

Extensions can:

• Add launcher commands — new things that appear when you search.
• Read and write to extension storage — a key-value store namespaced to that extension.
• Show small views — a panel that mounts inside the app's plugin frame.
• Use the host bridge — a typed set of app actions like opening a note, reading the clipboard, or showing a toast.

Extensions cannot run arbitrary shell commands through the public extension contract. The bridge gives them specific, typed access to app capabilities — nothing more.

Extension trust levels

QuickPeach uses two trust levels:

• Local extensions — unpacked modules you install from the Store or from a local folder (~/.quickpeach/extensions). These have access to the typed host bridge.
• Verified packages — extensions that go through a registry review, get signed, and have their artifacts hash-verified before install. These can access deeper integrations.

The Store shows which level each extension has. For extensions you didn't get from the Store, use local extensions only if you trust the source.

Build your own

Extensions are JavaScript modules with a manifest.json. A starter template and install script are included in the QuickPeach repository. See quickpeach.com/docs for the full guide.