REAPER Tools

You don’t call these tools yourself: describe what you want in plain language and Reagent picks them. Use this page to see what’s possible, so you know what to ask for.

Before You Start

REAPER is open and the Bridge is running. The Bridge (reagent_bridge) is a small script inside REAPER that passes commands between Reagent and REAPER; load it as shown in Quick Start. It stops when you quit REAPER, so run it again each time or have it start automatically. If either isn’t running when you send a message, Reagent can’t read or change your project in that reply; start it and send the message again.
The SWS extension is installed. Reagent needs it to read and edit media items. See System Requirements.
No dialog is open in REAPER. A dialog or popup can stop the Bridge from answering. After about 30 seconds (longer for long renders) the step fails and Reagent asks you to check REAPER; close the dialog and ask again.

Approvals and Undo

Tools that only read or measure never ask. For tools that change your project or write files, it depends on your permission mode:

Mode	Asks before
Default permissions	Every tool that changes your project or writes files
Auto-review	The same tools, except Add Markers
Full access	Nothing

Each tool that changes your project adds its own undo point in REAPER. Use Edit > Undo in REAPER (Cmd+Z on macOS, Ctrl+Z on Windows) to step back through them. Most undo points start with reagent:, for example “reagent: Delete 3 item(s)”. A multi-step request leaves several undo points. Some tools add more than one, such as Build variations. Take volume leveler does too when it levels many items at once. REAPER’s undo only covers the project: it doesn’t delete files that Reagent rendered to disk. See Undoing Changes.

Query Tools

These tools read your project without changing it. Reagent uses them for details such as fades, plugin settings or markers.

Tool	What it reads
Get project state	Project name and file path, sample rate, tempo and time signature, edit cursor, time and loop selection, counts of tracks, items, markers and regions, and whether there are unsaved changes
Get tracks	Track names, colors, mute and solo, volume, pan, item counts and folder structure, and optionally each track’s FX
Get media items	Items with their position, length, takes, fades and more, kept in working memory for later steps
Get markers and regions	Every marker and region with its position, name and color
Get installed plugins	Every installed plugin (VST, VST3, AU, CLAP, JS) with its type and, where the name shows it, the manufacturer. Filters by type, name, or instrument versus effect.
Check plugin params	Each parameter of FX on a track or take: index, name and kind of value (on/off, a list of choices, or a range). Reagent uses these to find the right parameter and value format before it changes a plugin setting.
Get source info	Source file type, length, path, channels, sample rate and file size, for selected items, specific files, or every source in the project
Get items by GUIDs	Finds specific items again by their REAPER ID (GUID), even after the selection has changed

How many tracks are in this project, and which ones are muted?
What plugins are on the Dialogue track?

What Reagent already knows with each message

Reagent doesn’t need these tools for the basics: with each message, it sends the AI model a short summary of your workspace, so you can say “these items” or “the selected track” without naming them.

Project: its name, how many tracks and items it has, the edit cursor position, the time selection, and any tracks that use fixed item lanes
Selection: the selected tracks and items. With five or fewer items selected, each item’s take or file name, track, position and length; with more, only how many are selected and across how many tracks.
Working memory: a one-line summary of what Reagent holds for this chat: how many items, up to three source file names, and what it has analyzed
Wwise: whether it’s connected and its version, and up to 10 objects selected there (see Using Your Wwise Selection)

Edit Tools

These tools ask for approval as described in Approvals and Undo, except Create script and Choose folder, which change nothing and never ask.

Tool	What it does
Run script	Runs a Lua script that Reagent writes, for jobs no other tool covers, such as creating tracks, adding FX, plugin settings, routing, track settings and envelopes. See ReaScript.
Create script	Writes a script for you to review without running it. You can run it, copy it, or choose Save to REAPER Actions.
Edit media item	Splits, deletes, copies, moves or trims items, or cuts time ranges out of them, such as filler words or dead air. Cutting a range leaves the gap in place; nothing after it moves.
Add Markers	Adds project markers in the color you ask for, at times you give (as unlabeled points) or from analysis results, such as every filler word or the start of each take. Markers from analysis results can be labeled from that data, and become regions when the results have end times.
Remove item silence	Splits sound-effect and other non-speech items at silences and removes the silent parts, leaving each sound as its own item in its original position. Not meant for dialogue.
Replace items	Swaps items for other items, keeping their track placement and alignment and copying their properties
Mark peaks on item	Finds transients or the loudest peaks in items and places take markers at them. It asks for approval only when it places markers.
Take volume leveler	Evens out the level of dialogue, voice-over or vocal items by writing a take volume envelope, optionally to a loudness target such as -23 LUFS. See Volume Leveling.
Render media	Renders items to audio or video files. See Rendering.
Choose folder	Opens your system’s folder picker, so you can choose where files go

Split the selected item every 2 seconds
Add a red marker at each transient on the drum track
Level these voice-over takes to -23 LUFS

Rendering

Render media writes items from your project to audio or video files. Reagent picks the items, usually your selection, and puts your selection back afterwards.

Formats: 24-bit WAV (Reagent’s default for audio), 16-bit WAV, 32-bit float WAV (keeps headroom), or MKV with FFV1 video (lossless video with 24-bit audio; needs video in the project). Other formats, such as MP3, FLAC or OGG, aren’t offered.
Settings: every format renders at 48 kHz stereo unless you ask otherwise. You can change the sample rate and channel count, and for WAV also dither and normalization. For another bit depth, pick another WAV format.
File names: each file is named after its item unless you ask for other names using REAPER’s wildcards, such as $item, $track and $project.
Folder: name a folder, or ask Reagent to open a folder picker. Reagent creates the folder if it doesn’t exist.

Reagent uses its own render settings for the job, then puts your project’s render settings back. Rendered files aren’t added to your project.

Render the selected items as 24-bit WAVs into my Desktop/Renders folder
Render these as 16-bit, 44.1 kHz mono WAVs and let me choose the folder

Variation Tools

Use these to turn a few source sounds into many usable variations. The Create Variations skill runs them in the right order for you.

Tool	What it does
Build variations	Makes a set number of copies of your source sounds after the last item in your project, each inside a region named `reagent var 1`, `reagent var 2` and so on. If your project also has alternative takes, it swaps those in, lined up with the original’s peaks (see How Create Variations Works). It doesn’t randomize anything by itself.
Randomize items	Varies pitch, volume, timing and playback rate, and can switch the pitch-shift mode, reverse or mute some items, add stretch markers or add a pitch envelope. Name an intensity or set each change yourself (see Randomization Intensity). Each run records a random seed, so you can ask for the same randomization again.

Make 8 subtle pitch and volume variations of the selected footsteps

Analysis Tools

These tools measure the items in your project without changing them. To analyze audio files on disk instead, see Audio Analysis. The analysis runs on your computer; Reagent sends the measurements to the AI model as text, not your audio. Reagent can’t hear playback or watch meters: its analysis tools read the audio files behind your items.

Tool	What it measures
Analyze spectrum	Each item’s energy across six frequency bands, relative to its strongest band, so it shows tonal balance, not loudness
Analyze item RMS	Each item’s loudness as RMS in dB, to compare items
Analyze item silence	Which items are effectively silent, not where the gaps are inside them (see Silence)
Analyze item transients	Where each hit or onset falls on the timeline and how loud it is, across tracks
Classify items	What an item contains, such as dialogue or ambience, and a suggested UCS category (see UCS Classification)

Which of these items are silent?
Which of these kick layers is the most bass-heavy?

Analyze spectrum and Classify items read the source audio as it is. For thresholds, spectrum bands and what the other measurements include, see Audio Analysis.

Dialogue Tools

These tools edit voice-over and podcast recordings as a chain: Transcribe dialogue, then Analyze transcription, then Apply edits. See Dialogue for the full workflow.

Tool	What it does
Transcribe dialogue	Turns the speech in items into text with word timings. It uploads the items’ audio to Reagent’s servers, where a speech-to-text service transcribes it.
Analyze transcription	Finds where each take starts and ends, and where to trim. Runs on Reagent’s servers.
Apply edits	Splits items at the takes that analysis found, trims them and renames each take to the words spoken
Dialogue manager	Shows the transcribed lines with timestamps, to search, copy or download as a PDF. It can also translate them into another language, which runs on Reagent’s servers.

Memory and Reference

Reagent can count, filter and compare what’s in its memory on your computer, without reading your project again. Memory is saved with the chat on your computer, not in your REAPER project, and comes back when you reopen the chat.

Tool	What it does
Snapshot	Reagent’s working memory for this chat. Tools that load or analyze items save them here with what they found, such as spectrum values, classifications or transcripts, 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, for example every filler word in a long transcript to mark or cut
Search docs	Searches REAPER’s scripting reference on reaperagent.com (REAPER API search), so Reagent can check function names and arguments when it writes a script

Memory holds the most recent results, not everything from a long chat. A new chat starts empty, so Reagent has to read 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 inside REAPER, and the result comes back so Reagent can take the next step or answer you. Reagent and the Bridge exchange commands through small files in a folder on your computer, not over the network. Tools run one at a time, because REAPER handles script commands in order. So “trim the silence from these, then build five variations” becomes a chain of steps, each able to use what the previous one found. The steps fold into a summary line in the reply, such as “Ran 6 tools”. Open it to see each step and the error behind a failed one, and hover over a step to see the tool’s name, which matches the tables above (see Chat).

A long job stopped partway

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.

Older chats show a REAPER subagent

Older chats may still show steps from a REAPER subagent that earlier versions used.

ReaScript

How Reagent writes, runs and saves scripts.

Permissions

Choose when Reagent asks before making changes.

Dialogue

Edit and level voice recordings.

Audio Analysis

Analyze audio files on disk.

Get Started

Using Reagent

REAPER & Wwise

Enterprise

Help

Before You Start

Approvals and Undo

Query Tools

Edit Tools

Rendering

Variation Tools

Analysis Tools

Dialogue Tools

Memory and Reference

Multi-Step Requests

ReaScript

Permissions

Dialogue

Audio Analysis

​Before You Start

​Approvals and Undo

​Query Tools

​Edit Tools

​Rendering

​Variation Tools

​Analysis Tools

​Dialogue Tools

​Memory and Reference

​Multi-Step Requests

​Related

ReaScript

Permissions

Dialogue

Audio Analysis

Before You Start

Approvals and Undo

Query Tools

Edit Tools

Rendering

Variation Tools

Analysis Tools

Dialogue Tools

Memory and Reference

Multi-Step Requests

Related