Getting started

Install the extension and the helper plugin, create an application password and add your first site.

Setting up a site takes a few minutes and three steps, once per site.

1. Install the extension

Install Bricks Builder from the Raycast Store. The extension is for Raycast on macOS. Shortcuts, snippets and docs search work right away, without a site.

2. Install the helper plugin

The free Bricks Raycast Helper plugin lets Raycast read your templates, global classes, colors, variables and dynamic data. It needs WordPress 6.0 and PHP 7.4 or newer, with Bricks active.

The extension ships the plugin ready to upload. In Bricks Site Health, press ⌘⇧H on a site: the plugin zip is saved to your Downloads folder and the site’s Plugins › Add New › Upload Plugin page opens. Upload it and activate it. See Helper plugin for updates.

3. Create an application password

In WordPress, go to Users › Profile › Application Passwords, add one named “Raycast” and copy it. Your user needs to be able to edit posts. Raycast signs in with this password, so your real password never leaves WordPress, and you can revoke it at any time.

The helper plugin’s settings page, under Settings › Bricks Raycast, has a button that opens Application Passwords and shows the site URL and username to copy.

4. Add the site in Raycast

Run Manage Bricks Sites and press ⌘N. Enter the site URL (⌘⇧B fills it from your browser tab, ⌘⇧P opens the site’s Application Passwords page), your WordPress username and the application password.

  • If the site lives at a different address, for example it redirects to www, it’s saved under that address.
  • For Local, DDEV or Herd sites, tick Allow self-signed certificate.

Manage Bricks Sites is also one shortcut away (⌘⇧M) in every command that uses a site.

5. Allow browser control

Search Bricks Shortcuts, Edit Current Page in Bricks and pasting snippets act on the frontmost browser tab. The first time, macOS asks you to allow Raycast to control your browser and System Events. Keep Bricks open in your browser for the builder commands.

Next steps

  • Browse the commands and give the ones you use most a hotkey.
  • Add a Pro license for the audit, element search, Template Library, form submissions and site tools.

Bricks Builder for Raycast and Bricks Raycast Pro are made and sold by Martej. They are not made, endorsed or supported by Bricks, Raycast or WordPress, and a Bricks Raycast Pro license is not part of a Bricks license.