Skip to main content
Reagent works with REAPER through the Bridge, a small script that runs inside REAPER and lets Reagent read and edit your project. You set it up in step 4. Using Reagent Enterprise? Sign in with your work email on the Enterprise tab in step 2, usually with your company’s single sign-on, then connect your organization’s AI endpoint at the end of step 3.

​
Before You Start

You need:
  • A Mac or Windows PC that meets the System Requirements.
  • REAPER 7.0 or later (reaper.fm), on the same computer and user account as Reagent.
  • Enterprise accounts: an endpoint URL, API key and model ID from your IT team.
  • The free SWS extension for REAPER. Reagent needs it to work with media items and doesn’t warn you if it’s missing, so install it first.
  1. Quit REAPER.
  2. Download the version for your platform from sws-extension.org and follow the install instructions there.
  3. Open REAPER, choose Actions > Show action list… and type SWS in the Filter box. If you see actions that start with SWS/S&M:, SWS is installed.

​
1. Download and Install Reagent

You don’t need an account yet. You create one or sign in from the app in step 2.
  1. Go to reaperagent.com/download and click Download for macOS.
  2. Open the .dmg file and drag Reagent into your Applications folder.
  3. Open Reagent from Applications.

​
2. Sign In

Sign-in happens in your web browser, not inside the app. While you sign in, Reagent shows Waiting for browser… with a Cancel button.
  1. In Reagent, click Sign in to Reagent. Your browser opens the Reagent sign-in page.
  2. Type your email.
    • Have an account? Enter your password and click Log in.
    • New to Reagent? Click Sign up when the page says No account found for this email. Enter your name, email and a password (at least 8 characters), then click Create account. If the page says it sent a confirmation link, click it in the email.
New accounts include free trial credits. See Plans and Credits.
The browser then shows Opening Reagent and hands you back to the app. If your browser asks whether to open Reagent, allow it.

​
3. Answer the Welcome Questions

The first time you sign in, Reagent asks a few questions to set up your profile.
  1. Click Get Started.
  2. Enter a Display Name and click Continue.
  3. On Tell us about yourself, answer and click Continue, or click Skip.
  4. Click Start Chatting.
You only see these screens once per account, so another computer skips them.

​
Connect Your Organization’s AI Endpoint

This section is for Enterprise accounts. Individual plans, including the free trial, skip to step 4, because Reagent provides the AI model. Reagent sends your requests to your organization’s own AI endpoint. After the welcome questions, or right after sign-in on another computer, a Custom Endpoint window asks you to connect it. You can’t close it or use Reagent until an endpoint works, and its only other option is Sign out.
1

Enter the details from your IT team

Endpoint URL, API key and Model ID are all required. The URL must start with https://, unless the model server runs on your own computer (localhost). Leave Provider, API, Reasoning effort and Advanced at their defaults unless IT says otherwise.
2

Click Apply

Reagent tests the endpoint before it saves anything. When the window shows Connected, click Continue.If the test fails, read the error under Apply and check the details with your IT team. If Reagent can’t reach the endpoint at all, check that you’re on your organization’s network or VPN. See Enterprise Endpoint Errors.
Reagent saves these settings, including the API key, on this computer only. It clears them when you log out or when your sign-in session ends. You then enter the endpoint again, as you do on each new computer. To change the endpoint later, use Settings > Endpoint. For every option, see Custom Endpoint.

​
4. Connect Reagent to REAPER

Each time Reagent starts, it copies the Bridge script, reagent_bridge.lua, into a reagent folder inside REAPER’s Scripts folder. You load it into REAPER’s action list once on each computer.
1

Open REAPER's action list

Open REAPER (any project works) and choose Actions > Show action list….
2

Load the script (first time only)

Click New action… and choose Load ReaScript…, then browse to the reagent folder for your platform:On macOS, if you can’t see the Library folder, press Cmd+Shift+G in the file dialog and paste:
Select reagent_bridge.lua and click Open. The list now shows Script: reagent_bridge.lua.
Tell Reagent where it is in Settings > Connectors first. Then browse to the reagent folder inside the Scripts folder you chose, not the one in the table.The green Script Installed status there only means the files are in place, not that the Bridge is running. See REAPER in a Custom Location.
3

Run the Bridge

Select Script: reagent_bridge.lua and click Run. The Bridge runs in the background and doesn’t open a window. From now on, run this step each time you open REAPER, unless you start the Bridge automatically.
REAPER's Actions window showing Script: reagent_bridge.lua in the list, with the New action... and Run buttons at the bottom
4

Check the connection

In Reagent, ask:
Reagent has no connection light. It checks REAPER each time you send a message, and tells you to run the Bridge script if REAPER isn’t connected.

​
5. Send Your First Request

Reagent sees what’s selected in REAPER, including tracks, items, the edit cursor and the time selection. Try your first few requests on a copy of a project.
  1. In REAPER, select a track.
  2. In Reagent, type a request in the box that says How can I help you today? For example:
  3. Press Enter to send, or Shift+Enter for a new line.
  4. Before Reagent changes your project, it shows what it wants to do. Click Allow to go ahead, or Deny to skip that change and let Reagent carry on. From the keyboard, Cmd+Enter (macOS) or Ctrl+Enter (Windows) allows, and Esc denies and also stops the reply.
Reagent starts in Default permissions mode, so it asks before it changes your project or your files. To change how often it asks, see Permissions. Each change Reagent makes in REAPER gets its own entry in REAPER’s undo history, so you can undo it with Cmd+Z (macOS) or Ctrl+Z (Windows). See Undo and Recovery. More requests to try:

​
Start the Bridge Automatically

The Bridge stops when you quit REAPER. To have it start whenever you open REAPER, make it SWS’s global startup action. It’s optional, but it saves a step every session.
1

Check for an existing startup action

SWS keeps only one global startup action, so this replaces any you already have. To check, run SWS/S&M: Show project/global startup actions in the action list.
2

Copy the Bridge's command ID

In the action list, type reagent in the Filter box. Right-click Script: reagent_bridge.lua and choose Copy selected action command ID.
Right-click menu on Script: reagent_bridge.lua with Copy selected action command ID highlighted
3

Open the SWS startup action setting

Change the filter to global start. Select SWS/S&M: Set global startup action and click Run.
Action list filtered by global start, with SWS/S&M: Set global startup action selected
4

Paste the ID and save

Paste the command ID into the Set global startup action box and click OK. From now on, the Bridge starts whenever you open REAPER.
The Set global startup action dialog with the Bridge's command ID pasted in
Once the startup action starts the Bridge, you don’t need to run it yourself. If you do, REAPER asks whether to terminate instances or start a new instance. Don’t choose New instance: two copies of the Bridge would carry out every change twice. If you choose Terminate instances, the Bridge stops, so run it again. See REAPER Connection Problems.

​
Set Up Another Computer

Your account and profile follow you, so a second computer skips the welcome questions. REAPER setup is per computer, though. On each new computer:
  1. Install REAPER and SWS (Before You Start).
  2. Install Reagent and sign in (steps 1 and 2).
  3. Enterprise accounts: enter your endpoint again when the Custom Endpoint window opens (Connect Your Organization’s AI Endpoint).
  4. Load and run the Bridge (step 4), and optionally start it automatically.

​
If Something Doesn’t Work

If the Opening Reagent page shows an Open Reagent button, click it. Reagent waits up to 10 minutes for you to finish in the browser. If you take longer, close the tab, or the button doesn’t work, click Cancel in Reagent if it’s still waiting, then Sign in to Reagent again.
REAPER only lists the script after you’ve loaded it once. See step 4.
Reagent couldn’t copy the Bridge files. Click Setup to open Device Setup. It installs the files and walks you through steps similar to step 4.
Usually the Bridge isn’t running. Run it (step 4), then send your message again. If Reagent recently updated, quit and reopen REAPER first.Still not connected? Close any open dialog box in REAPER. If that doesn’t help, deselect all media items and ask again. If Reagent now connects, SWS is missing. See REAPER Connection Problems.
If an error says REAPER rejected the operation and Show details mentions BR_GetMediaItemGUID or SWS, SWS is missing. Install it (Before You Start), then restart REAPER and run the Bridge, or let the startup action run it. See SWS Extension Missing.
The update includes a new version of the Bridge. Quit and reopen REAPER, then run the script, or let the startup action run it. You don’t need to load it again.
For more fixes, see Troubleshooting.

Chat

Talk to Reagent, attach files and follow its work.

Permissions

Choose how often Reagent asks before it makes changes.

Example Workflows

Practical prompts for everyday jobs in REAPER and Wwise.

Best Practices

Write clear requests and keep your projects safe.