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

# Settings

> Manage your profile, slash commands and REAPER Bridge, and see how shortcuts, the theme and updates work

export const NotOnEnterprise = ({size = "sm", legend = false}) => <span data-plan-marker={legend ? undefined : "not-enterprise"}>
    <Tooltip headline="Not on Enterprise" tip="Available on individual plans. Not available to Reagent Enterprise accounts." cta="Compare plans" href="/docs/enterprise/overview#feature-availability">
      <Badge icon="ban" color="gray" size={size} shape="pill" stroke>
        Not on Enterprise
      </Badge>
    </Tooltip>
  </span>;

export const ForEnterprise = ({size = "sm"}) => <span data-plan-marker="enterprise-only" hidden={true}></span>;

export const Availability = ({enterprise = "available", children}) => {
  const lead = ({
    available: "Available on every plan, including Enterprise.",
    limited: "Limited on Enterprise.",
    unavailable: "Not available on Enterprise."
  })[enterprise];
  const icon = ({
    available: "circle-check",
    limited: "circle-half-stroke",
    unavailable: "ban"
  })[enterprise];
  return <div data-plan-page={enterprise}>
      <Callout icon={icon} color="#71717a">
        <strong>{lead}</strong> {children}{" "}
        <a href="/docs/enterprise/overview#feature-availability">Compare plans</a>
      </Callout>
    </div>;
};

To open Settings, press `Cmd+,` (macOS) or `Ctrl+,` (Windows), or click your name at the bottom of the sidebar and choose **Settings**. To leave, click any chat in the sidebar.

<Availability enterprise="limited">The **Endpoint** tab replaces **Subscription**, and you can't delete your own account. The other tabs, the theme switch and updates work the same way.</Availability>

| Tab                                                   | What it's for                                                                                                                        |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **General**                                           | Your Reagent **Version** (have it ready for support) and **View Changelog**, which opens the [changelog](/docs/changelog) in your browser |
| [**Account**](#account)                               | Your profile: display name, email and how you use REAPER                                                                             |
| [**Subscription**](#subscription) <NotOnEnterprise /> | Your plan and credit balance                                                                                                         |
| [**Endpoint**](#endpoint)                             | Your organization's AI endpoint <ForEnterprise />                                                                                    |
| [**Commands**](#commands)                             | Your slash commands                                                                                                                  |
| [**Connectors**](#connectors)                         | The REAPER Bridge                                                                                                                    |
| [**Shortcuts**](#keyboard-shortcuts)                  | A list of keyboard shortcuts                                                                                                         |

The theme switch and updates aren't in Settings. See [Appearance](#appearance) and [Updates](#updates).

## Account

**Profile** holds your answers to the welcome questions from your first sign-in. It's saved to your Reagent account, so it's the same on every computer.

| Field                   | Details                                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Display Name**        | Required, 2 to 50 characters. Shown at the bottom of the sidebar.                                            |
| **Email**               | Read-only ("Email cannot be changed")                                                                        |
| **REAPER Experience**   | **Beginner**, **Intermediate**, **Advanced** or **Professional**                                             |
| **Primary Use Cases**   | Any of **Music Production**, **Sound Design**, **Podcast / Voice**, **Film / TV**, **Game Audio**, **Other** |
| **Professional Status** | **Hobbyist**, **Freelancer**, **Studio Employee** or **Student**                                             |

**Save Changes** becomes available once you change something. "Profile saved successfully" confirms the save.

These account tasks happen outside Settings:

* **Reset your password**: click **Sign in to Reagent**, then **Forgot password?** on the sign-in page in your browser. Enter your email and click **Send reset link**, and Reagent emails you a link to set a new password.
  * Email-and-password sign-in only; SSO accounts have no Reagent password. <ForEnterprise />
* **Log out**: click your name in the sidebar and choose **Log out**. This signs you out on all your computers, not only this one.
* **Remove your account**: on an Enterprise account, ask your administrator, who arranges removal with Reagent's team. See [Removing Someone's Access](/docs/enterprise/sso#removing-someone%E2%80%99s-access). <ForEnterprise />

### Deleting Your Account <NotOnEnterprise />

You can't delete your account from the app. Delete it from the web dashboard instead.

<Warning>This can't be undone. Any active subscription is cancelled right away, and you lose your remaining credits, including purchased credits.</Warning>

1. Go to the Account page of the [web dashboard](https://www.reaperagent.com/dashboard/account).
2. Click **Delete account**.
3. Type `delete my account` and click **Delete forever**.

## Subscription <NotOnEnterprise />

| Item                    | Details                                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Current Plan**        | Your plan's name                                                                                                          |
| **Credits This Period** | How many credits you have left, with a bar underneath. **Refresh** reloads it.                                            |
| **Manage Billing**      | Opens the [web dashboard](https://www.reaperagent.com/dashboard/overview) in your browser to manage your plan and billing |
| **Upgrade**             | Shown on the free plan ("You're on the free plan with limited credits."). Opens the plans on the website.                 |

See [Plans and Credits](/docs/account/plans-and-credits) for how plans and credits work.

## Endpoint <ForEnterprise />

On Enterprise accounts, Reagent sends your chats to your organization's AI endpoint instead of Reagent's own models. This tab is where you change that connection.

| Item                                              | What it does                                                                                                                                                       |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Connection**                                    | Has the same fields as the **Custom Endpoint** window you filled in after signing in                                                                               |
| **Detected**                                      | Shows which API Reagent is using with your endpoint                                                                                                                |
| **Apply**                                         | Tests the endpoint and saves your changes                                                                                                                          |
| **Clear**, next to **Saved endpoint credentials** | Removes the saved endpoint, API key, model ID and provider selection from this computer after you confirm. You then set up the endpoint again before you can chat. |

These settings stay on this computer only. Reagent clears them when you log out or your sign-in session ends, so you enter them again the next time you sign in. For what each field does, see [Custom Endpoint](/docs/enterprise/custom-endpoint).

## Commands

Slash commands are prompts you save once and run by typing `/` and the command's name in chat.

| Item               | What it does                                                                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **New command**    | Opens the editor, with a **Name** and an **Instructions** field                                                                                                           |
| **Edit**           | Edits the command. You can also click the command itself.                                                                                                                 |
| Trash icon         | Deletes the command after you confirm. You can't undo this.                                                                                                               |
| **Open in Finder** | Opens Reagent's app data folder with the `commands` folder selected. Each command is a `.md` file inside. The label is the same on Windows, where it opens File Explorer. |

For naming rules and examples, see [Slash Commands](/docs/features/slash-commands).

## Connectors

**Connectors** manages the REAPER Bridge, a small Lua script that runs inside REAPER and lets Reagent work on your project.

**Script Installed** only means the Bridge files are in the folder, not that the Bridge is running in REAPER. Installing the files doesn't start it. Load `reagent_bridge.lua` into REAPER's action list once per computer, then run it each time you open REAPER, or start it automatically with the SWS extension ([Quick Start](/docs/getting-started/quickstart#4-connect-reagent-to-reaper)).

To check that the Bridge is running, ask Reagent "Is REAPER connected?" Reagent also checks each time you send a message: if the Bridge isn't responding and your request needs REAPER, it tells you to open REAPER and run the Bridge script.

| Item                          | What it does                                                                                                                                                                                                                                  |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **REAPER path**               | The REAPER `Scripts` folder the Bridge installs into, in a `reagent` folder                                                                                                                                                                   |
| **Change path** (folder icon) | Lets you pick REAPER's resource folder ([how to find it](/docs/guides/troubleshooting#reaper-in-a-custom-location)) or its `Scripts` folder instead, for example for a portable install. Reagent moves the Bridge right away, with no Save button. |
| Status                        | **Script Installed** with the Bridge version, or **Script Not installed**                                                                                                                                                                     |
| **Install**                   | Appears when the Bridge files are missing. Copies them in.                                                                                                                                                                                    |
| **Reinstall** (download icon) | Copies the Bridge files again, replacing the installed ones                                                                                                                                                                                   |
| **Uninstall** (trash icon)    | Removes the Bridge files. Reagent copies them back the next time it starts.                                                                                                                                                                   |

Default folder: `~/Library/Application Support/REAPER/Scripts` on macOS, `%APPDATA%\REAPER\Scripts` on Windows.

<AccordionGroup>
  <Accordion title="Searching the action list for reagent_bridge finds nothing">
    The tab's note, **Run script every time you re-open REAPER**, says to search the action list for `reagent_bridge`. That search only finds the script after you've loaded it once.
  </Accordion>

  <Accordion title="A Bridge Updated message appears">
    Reagent copies the Bridge files every time it starts. When a new Reagent version includes a new Bridge, a **Bridge Updated** message asks you to restart the Bridge script in REAPER.
  </Accordion>

  <Accordion title="Where are the Wwise settings?">
    **Connectors** has no Wwise settings. When Wwise Authoring is open on this computer with the Wwise Authoring API (WAAPI) turned on, Reagent finds it on its own when you send a message. See [Wwise](/docs/features/wwise).
  </Accordion>
</AccordionGroup>

## Keyboard Shortcuts

The **Shortcuts** tab lists the main shortcuts, and you can't change them. `Cmd/Ctrl` means `Cmd` on macOS and `Ctrl` on Windows. Zoom shortcuts are under [Appearance](#appearance).

| Action                                                                                  | Keys          |
| --------------------------------------------------------------------------------------- | ------------- |
| New chat (the cursor goes to the message box)                                           | `Cmd/Ctrl+N`  |
| Show or hide the sidebar                                                                | `Cmd/Ctrl+B`  |
| Open Settings                                                                           | `Cmd/Ctrl+,`  |
| Send your message                                                                       | `Enter`       |
| Add a new line to your message                                                          | `Shift+Enter` |
| Stop the current reply (not while you're typing in another field, such as a search box) | `Esc`         |
| Quit Reagent (macOS only)                                                               | `Cmd+Q`       |

On Windows, close the window to quit. The **Shortcuts** tab shows `Cmd/Ctrl+Q`, but it doesn't apply there.

These keys work when their card, list or field is active. For approval and question cards, see [Chat](/docs/features/chat-interface) and [Permissions](/docs/features/permissions).

| Where                                                                        | Action                                                            | Keys                    |
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------- |
| Approval card                                                                | Allow the change                                                  | `Cmd/Ctrl+Enter`        |
|                                                                              | Deny the change and stop the reply                                | `Esc`                   |
| Question card                                                                | Move between answers                                              | `↑` and `↓`             |
|                                                                              | Pick an answer by the number next to it                           | `1` to `4`              |
|                                                                              | Pick the highlighted answer, or tick it if you can choose several | `Enter`                 |
|                                                                              | Tick or untick an answer (choose several)                         | `Space`                 |
|                                                                              | Send your answers (choose several)                                | `Cmd/Ctrl+Enter`        |
|                                                                              | Cancel the question and stop the reply                            | `Esc`                   |
| Command list (after you type `/`)                                            | Move through commands                                             | `↑` and `↓`             |
|                                                                              | Insert the highlighted command                                    | `Enter` or `Tab`        |
|                                                                              | Close the list                                                    | `Esc`                   |
| Command editor                                                               | Save                                                              | `Cmd/Ctrl+S`            |
|                                                                              | Leave (asks first if you changed something)                       | `Esc`                   |
| [Dialogue view](/docs/features/dialogue#dialogue-view) search <NotOnEnterprise /> | Next match / previous match                                       | `Enter` / `Shift+Enter` |
|                                                                              | Close the search <NotOnEnterprise />                              | `Esc`                   |

## Appearance

* **Light and dark theme**: click the sun or moon button at the top right of the title bar. Until you first click it, Reagent follows your system's appearance. After that, it keeps your choice on this computer, with no option to go back to following the system.
* **Reduced motion**: when your operating system's reduce-motion setting is on, Reagent turns off or simplifies most animations, such as the wipe when you switch themes.
* **Interface size** (macOS): in the **View** menu, choose **Zoom In** (`Cmd+Plus`), **Zoom Out** (`Cmd+Minus`) or **Actual Size** (`Cmd+0`).

## Updates

Reagent keeps itself up to date:

1. **Check.** Reagent checks for a new version each time you open it. There's no manual check button: quit and reopen Reagent to check again.
2. **Download.** The update downloads in the background. A small progress ring in the title bar shows how far along it is.
3. **Install.** When the download finishes, Reagent shows **Update Ready to Install** with an **Install Now** button, and a download-arrow button appears in the title bar (hover it for the version number).

   Click either to install now. On macOS, Reagent restarts into the new version. On Windows, Reagent closes and its installer finishes the update. If you don't click either, the update installs when you quit Reagent.

The first time you open Reagent after an update (not after a fresh install), the **What's New** window lists the **New Features**, **Improvements** and **Bug Fixes** in every version since the one you had. Click **Got it** to close it, or the link icon next to the title to open the full [changelog](/docs/changelog).

<AccordionGroup>
  <Accordion title="Reagent doesn't update on my network">
    Updates download from Reagent's releases on GitHub. On a network that blocks GitHub, Reagent can't update itself.
  </Accordion>

  <Accordion title="What's New says No changelog available">
    The notes come from reaperagent.com. If Reagent can't load them, the window says "No changelog available."
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Chat" icon="message" href="/docs/features/chat-interface">
    Send requests, approve changes and answer Reagent's questions.
  </Card>

  <Card title="Slash Commands" icon="terminal" href="/docs/features/slash-commands">
    Create and run your own saved prompts.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/docs/getting-started/quickstart">
    Load and run the REAPER Bridge.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/docs/guides/troubleshooting">
    Fix connection and app problems.
  </Card>
</CardGroup>
