> ## Documentation Index
> Fetch the complete documentation index at: https://reaperagent.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get Reagent connected to REAPER in a few minutes

This guide gets you up and running with Reagent as quickly as possible. For detailed installation instructions, see the [full installation guide](/getting-started/installation).

<Note>
  Before starting, make sure you have REAPER installed on your computer. Reagent works with any version of REAPER that supports Lua scripting.
</Note>

## 1. Create Your Account

Create an account at [reaperagent.com/signup](https://www.reaperagent.com/signup) before downloading the app.

## 2. Download and Install Reagent

1. Download Reagent from [reaperagent.com/download](https://www.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](https://www.sws-extension.org/) is required for Reagent to access advanced REAPER features.

<Steps>
  <Step title="Download SWS">
    Visit [sws-extension.org](https://www.sws-extension.org/) and download the installer for your platform.
  </Step>

  <Step title="Run the Installer">
    Close REAPER if it's running, then run the SWS installer.
  </Step>

  <Step title="Verify Installation">
    Open REAPER and look for "Extensions" in the menu bar. If you see SWS-related options, you're set.
  </Step>
</Steps>

## 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

<Warning>
  **Highly recommended:** Configure the Bridge to start automatically with REAPER. Otherwise, you'll need to run it manually each session for Reagent to connect.
</Warning>

<Accordion title="How to automatically start the Bridge with REAPER" defaultOpen>
  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:

  <Steps>
    <Step title="Find the Bridge action">
      In REAPER, go to **Actions > Show action list** (or press `?`) and search for `reagent_bridge`.

      <Frame>
        <img src="https://mintcdn.com/distort/3Shn8wuWaQ6K1p8p/images/screenshots/set-startup-action/01-reagent-bridge.png?fit=max&auto=format&n=3Shn8wuWaQ6K1p8p&q=85&s=7242cd86a7d9c94a64f4b6e1d7adb67f" alt="Finding the reagent_bridge action in REAPER's action list" width="1824" height="1376" data-path="images/screenshots/set-startup-action/01-reagent-bridge.png" />
      </Frame>
    </Step>

    <Step title="Copy the command ID">
      Right-click the `reagent_bridge` action and select **Copy selected action command ID**.

      <Frame>
        <img src="https://mintcdn.com/distort/3Shn8wuWaQ6K1p8p/images/screenshots/set-startup-action/02-reagent-bridge-copy-id.png?fit=max&auto=format&n=3Shn8wuWaQ6K1p8p&q=85&s=99cdcd52f2928f9db482e8e54b3d5fc2" alt="Copying the command ID of the reagent_bridge action" width="1630" height="1172" data-path="images/screenshots/set-startup-action/02-reagent-bridge-copy-id.png" />
      </Frame>
    </Step>

    <Step title="Find SWS startup action">
      Run Set global startup action...

      <Frame>
        <img src="https://mintcdn.com/distort/3Shn8wuWaQ6K1p8p/images/screenshots/set-startup-action/03-sws-global-start.png?fit=max&auto=format&n=3Shn8wuWaQ6K1p8p&q=85&s=2097b99e453bb61ff1457f471045c7fd" alt="Opening SWS global startup action settings" width="1824" height="1376" data-path="images/screenshots/set-startup-action/03-sws-global-start.png" />
      </Frame>
    </Step>

    <Step title="Paste and save">
      Paste the command ID and click **OK**. The Bridge will now start automatically whenever you open REAPER.

      <Frame>
        <img src="https://mintcdn.com/distort/3Shn8wuWaQ6K1p8p/images/screenshots/set-startup-action/04-sws-assign-global-start.png?fit=max&auto=format&n=3Shn8wuWaQ6K1p8p&q=85&s=b9fca2682074a326628848974d91bb9e" alt="Assigning the reagent_bridge as the global startup action" width="1596" height="1148" data-path="images/screenshots/set-startup-action/04-sws-assign-global-start.png" />
      </Frame>
    </Step>
  </Steps>
</Accordion>

## 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

<CardGroup cols={2}>
  <Card title="Full Installation Guide" icon="book" href="/getting-started/installation">
    Detailed setup including permissions and troubleshooting.
  </Card>

  <Card title="Features Overview" icon="sparkles" href="/features">
    Explore everything Reagent can do.
  </Card>

  <Card title="Example Workflows" icon="lightbulb" href="/guides/common-workflows">
    See practical examples and prompts.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/guides/troubleshooting">
    Having issues? Check common solutions.
  </Card>
</CardGroup>