Skip to main content
You don’t call these tools yourself. Describe what you want in plain language, and Reagent picks them.

​
Before You Start

​
Approvals and Undo

Reading and measuring never ask. Auto-review also lets Add Markers through. See Permissions. Each change adds an undo point in REAPER, most named reagent: …. A multi-step request leaves several, as do Build variations and, on many items, Take volume leveler. REAPER’s undo doesn’t delete rendered files (Undoing Changes). Changes to REAPER’s preferences and themes add no undo point: you revert them instead (REAPER Preferences, REAPER Themes).

​
Query Tools

These read your project.
Each message also carries a short summary of your project and selection, so you can say “these items” or “the selected track” (what’s sent).

​
Edit Tools

​
Rendering

Render media renders the items Reagent picks, usually your selection, then restores your selection.
  • Formats: 24-bit WAV (the default), 16-bit WAV, 32-bit float WAV, or MKV with lossless FFV1 video and 24-bit audio (needs video in the project). No MP3, FLAC, OGG or other formats.
  • Settings: 48 kHz stereo unless you ask otherwise. You can change the sample rate and channels, and for WAV, dither and normalization.
  • File names: one file per selected item, named after the item or with REAPER wildcards you ask for, such as $item, $track and $project.
  • Folder: name one, or ask for a folder picker. Reagent creates it if it doesn’t exist.
  • Afterwards: your project’s render settings are restored, and rendered files aren’t added to the project.
  • In the background: renders work while REAPER isn’t the app in front. Reagent brings your media online first, and tells you when a file comes out silent instead of reporting success. See Silent Renders and Offline Media.

​
Variation Tools

The Create Variations skill runs these in the right order for you.

​
Analysis Tools

Analyze spectrum, Analyze item RMS, Analyze item silence, Analyze item transients and Classify items measure items without changing them. They run on your computer and send the AI model the measurements as text, not your audio. Reagent can’t hear playback or watch meters: it reads the audio files behind your items. See Audio Analysis, which also covers files on disk.

​
REAPER Preferences

Reagent reads and changes a short list of REAPER preferences whose meaning it has checked. Ask in plain words: it reads the current value first, then changes only what you asked for.
  • What it can change: whether REAPER takes your media offline while another app is in front, whether it rebuilds peaks when that media comes back, and whether it closes its audio device while it’s stopped in the background, including while tracks are armed or ReWire is open. It can read the rest of its list, such as the tooltip delay and the project sample rate, without changing them. Change any other preference in REAPER’s Preferences.
  • Permanent: REAPER keeps a change after it quits. The approval card shows each setting’s value before and after, and when the change takes effect. When you turn off media going offline, Reagent also brings your media back online right away.
  • Recorded and revertible: Reagent records every change before it makes it. To undo one, ask Reagent to revert it, or click Revert in Settings > REAPER. If you’ve changed the setting in REAPER since, Reagent tells you and shows the current value before it puts the old one back.
  • REAPER 7.74 or later is needed to change preferences. Older versions can still read them.
Settings > REAPER lists these preferences, warns when one gets in Reagent’s way (such as media going offline while you work in Reagent), offers a fix, and shows every recorded change with Revert. On/off preferences show as switches: flipping one changes REAPER right away and records the change. A switch with a lock is one Reagent doesn’t change yet; select its row to see where to change it in REAPER.

​
REAPER Themes

Reagent can list REAPER’s themes, switch between them, change a theme’s colours, its other settings and its theme adjuster settings, and make a new theme from one you have. It works with the themes in REAPER’s ColorThemes folder and REAPER’s own stock themes, and names them by file name.
  • What it can change: colours; on/off switches, such as the coloured bar on selected items or interlaced VU meters; blend modes, which set how fills such as the time selection mix with what’s under them; and fonts, such as the timeline font. If a font isn’t installed on your computer, REAPER shows its fallback font instead. On macOS, a bold or italic font also shows the fallback font unless that style of the font is installed. REAPER’s own font, Inter, which the Default 7 theme uses, comes without either style, so on macOS, for a heavier Inter, ask for Inter Medium. Reagent can’t change a theme’s images. It changes a theme’s layout, and colours its layout sets itself, only as far as the theme adjuster settings below allow.
  • Permanent: REAPER keeps a theme switch after it quits. Colour and other theme changes stay too: Reagent saves them into a theme file it makes, such as Default_7.0 (Reagent).ReaperTheme, and REAPER switches to it. Its images and layout still come from the theme it’s based on, so a REAPER update that changes a stock theme changes them too. Your changes stay.
  • Theme adjuster settings: Reagent can change the settings REAPER’s theme adjuster offers, such as gamma, shadows, midtones, highlights, saturation and tint, and a theme’s own layout options, such as Default 7’s track folder indent. On their own, they’re set on the theme REAPER shows, without a new theme file, and REAPER keeps them for that theme.
  • Never overwritten: Reagent never changes REAPER’s stock themes or theme files you made or downloaded. It only rewrites a theme file it made itself, and only if you haven’t changed it since in REAPER; otherwise it makes a new file.
  • Checked first: if REAPER shows a different theme by the time Reagent makes the change, for example because you picked one yourself, Reagent doesn’t switch REAPER and asks you first. If it had already saved a new theme file, that file stays in REAPER’s ColorThemes folder; a theme file it was updating gets back what it held before.
  • Recorded and revertible: Reagent records every theme change before it makes it. To undo one, ask Reagent to revert it, or click Revert in Settings > REAPER. Reverting a new theme switches REAPER back and keeps the file. Theme adjuster changes revert only while that theme is showing. If you’ve picked another theme since, Reagent tells you before it switches back. It can’t put a theme file back as it was after you’ve edited that file in REAPER, or switch back to a theme whose file is gone, and it tells you why.

​
Match REAPER’s Theme to Reagent

In Settings > REAPER, under REAPER theme, choose a Light theme and a Dark theme, then turn on Match REAPER’s theme to Reagent’s light/dark. When Reagent switches between light and dark, because you changed its appearance or your computer did, REAPER switches to the matching theme. You can also ask Reagent to set this up.
  • It’s off until you turn it on, and REAPER needs to be open with the Bridge running. If REAPER isn’t reachable, it switches the next time Reagent reaches it.
  • Turning it on, clicking Resume, or asking Reagent to turn it on (also when it’s already on) switches REAPER right away to the theme for Reagent’s current appearance, even away from a theme you picked yourself. Choosing a new light or dark theme while it’s on applies your pair again: if REAPER shows one of your old or new light and dark themes, it switches to the one for Reagent’s current appearance. Reagent records each switch, so you can revert it.
  • While REAPER is recording, Reagent waits and switches when recording stops, also after you turn it on or click Resume.
  • If you pick another theme in REAPER yourself, Reagent leaves it. The next time Reagent applies your pair (when its appearance changes, when you choose a new light or dark theme, or when Reagent starts again), it pauses instead, and Settings > REAPER shows Paused with a Resume button. The first time Reagent pauses for a theme since it started, a notice with Resume appears as well. If Reagent isn’t in front, your computer shows the notice too, without a sound, and Resume waits for you in Reagent. If you pick the other of your two themes yourself, REAPER keeps it until Reagent next applies your pair.
  • Asking Reagent to switch to or make a theme outside your two themes pauses it too, and Reagent shows no notice for that theme until it restarts. A first change to a theme’s colours or other settings makes a new (Reagent) theme and switches to it, which pauses it the same way, so set that theme as your light or dark theme, or click Resume in Settings > REAPER.

​
Dialogue Tools

The first three run as a chain to edit voice-over and podcast recordings. See Dialogue.

​
Memory and Reference

  • Snapshot: Reagent’s working memory for this chat. Tools that load or analyze items save them here with what they found, so a later step can act on exactly those items (“delete the empty ones”).
  • Analyst: a helper that works through large results in working memory and saves what it finds for the next step, such as every filler word in a long transcript.
  • Search docs: searches REAPER’s scripting reference on reaperagent.com (REAPER API search) when Reagent writes a script.
Memory is saved with the chat on your computer, not in your project, and holds only the most recent results. A new chat starts empty, so Reagent reads your items again. If you need transcripts, Reagent has to transcribe them again too.

​
Multi-Step Requests

For each step, Reagent picks a tool, the Bridge runs it in REAPER, and the result comes back for the next step. Tools run one at a time, so “trim the silence from these, then build five variations” becomes a chain where each step can use what the last one found. Hover over a step in the reply to see the tool’s name, which matches the tables on this page (Chat). Reagent takes up to 25 rounds of actions in a row, and the count restarts each time you answer an approval card or a question. If a long job stops, ask it to continue.