Skip to main content
This guide gets you up and running with Reagent as quickly as possible. For detailed installation instructions, see the full installation guide.
Before starting, make sure you have REAPER installed on your computer. Reagent works with any version of REAPER that supports Lua scripting.

1. Create Your Account

Create an account at reaperagent.com/signup before downloading the app.

2. Download and Install Reagent

  1. Download Reagent from reaperagent.com/download
  2. Run the installer and follow the prompts
  3. Launch Reagent and sign in with your account

3. Install the SWS Extension

The SWS/S&M Extension is required for Reagent to access advanced REAPER features.
1

Download SWS

Visit sws-extension.org and download the installer for your platform.
2

Run the Installer

Close REAPER if it’s running, then run the SWS installer.
3

Verify Installation

Open REAPER and look for “Extensions” in the menu bar. If you see SWS-related options, you’re set.

4. Complete the Onboarding

Launch Reagent and sign in with your account. The onboarding wizard will guide you through:
  1. Installing the REAPER Bridge
  2. Connecting to REAPER
  3. Verifying everything works
Highly recommended: Configure the Bridge to start automatically with REAPER. Otherwise, you’ll need to run it manually each session for Reagent to connect.

How to automatically start the Bridge with REAPER

By default, you need to run the reagent_bridge action each time you open REAPER. To skip this step forever, set it as a global startup action using the SWS extension:
1

Find the Bridge action

In REAPER, go to Actions > Show action list (or press ?) and search for reagent_bridge.
Finding the reagent_bridge action in REAPER's action list
2

Copy the command ID

Right-click the reagent_bridge action and select Copy selected action command ID.
Copying the command ID of the reagent_bridge action
3

Find SWS startup action

Run Set global startup action…
Opening SWS global startup action settings
4

Paste and save

Paste the command ID and click OK. The Bridge will now start automatically whenever you open REAPER.
Assigning the reagent_bridge as the global startup action

5. Send Your First Command

With the Bridge connected, you’re ready to use Reagent.
  1. Type a message in the chat input, for example:
    Is REAPER connected?
    
  2. Press Enter to send
  3. Reagent will query REAPER and display the results
Try some other commands:
  • “Create 4 new tracks named Drums, Bass, Keys, and Vocals”
  • “Rename all media item on this track to sfx_explo_01.. etc increment name”
  • “Cut everything below 100Hz on this track”

Next Steps