Skip to main content
The chat interface is your primary way to interact with Reagent. Type natural language requests, and Reagent translates them into actions.

​
Sending Messages

Type your request in the message input at the bottom of the screen and press Enter to send. You can be conversational: 
Remove anything below 100Hz on the item that has most amount of low-end.
Or direct: 
Analyze all selected media item spectrum and check which one has the most amount of low-end. Add EQ to that item and apply highpass at 100Hz.
Reagent understands your intent by gathering context using different tools at its disposal.

​
Attaching Files

You can attach reference files to your messages for use during processing — like a script for dialogue editing, a spreadsheet for batch renaming, or a PDF for reference. To attach a file:
  • Click the + button in the chat input toolbar and select “Attach file” or “Attach folder”
  • Paste a file path directly into the input — paths starting with /, ~/, or C:\ are automatically detected and converted to file chips
Attached files appear as inline badges in your message. You can attach multiple files alongside your text. Supported file types include: PDF documents, Word documents (.docx), Excel spreadsheets (.xlsx), text files, and images. 
Edit the dialogue on the VO track using the attached script as reference

​
Chat Sessions

​
Starting New Sessions

Click the New Chat button (or use the keyboard shortcut) to start a fresh conversation. Previous context is cleared, and you begin with a clean slate.
Start a new session when switching to an unrelated task. This helps Reagent focus on your current request without confusion from earlier conversation. This also slightly lowers credit usage.
Only one chat can be active at any given moment. Do not attempt to run simultaneous chats as this can lead to your REAPER session getting corrupted.

​
Session History

Your chat history is saved automatically. You can:
  • Scroll back through previous messages in the current session
  • Review past sessions from the sidebar
  • Resume where you left off when you reopen Reagent

​
Understanding Responses

When Reagent processes your request, you’ll see:

​
Tool Calls

When Reagent needs information from REAPER or needs to perform an action, it uses tools. You’ll see the tool name and its output: Tool call example showing get_tracks output

​
Agent Errors

If something goes wrong and you see some red text with the tool output. Don’t be alarmed, Reagent will attempt to recorrect itself.

​
Tips for Effective Prompts

​
Be Specific

The more specific your request, the better the results:
Less EffectiveMore Effective
”Fix the tracks""Rename tracks 1-4 to match their first item’s filename"
"Organize this""Move all items with ‘SFX’ in the name to track 10"
"Make it sound more sci-fi""Add flanger plugin to the loudest layers and randomize paramters”

​
Reference Selections

Reagent automatically reads your current REAPER state — selected items, selected tracks, cursor position, and time selection — every time you send a message. You don’t need to describe your selection; just refer to it naturally:
  • “Analyze the selected items”
  • “What tracks are currently selected?”
  • “Rename all items within each region to match the region name with incremented suffixes”
  • “Remove silence from items within the time selection”

​
Chain Operations

For complex operations, you’ll get better results by describing multi-step workflows with clear intentions: 
For each selected item:
1. Detect the peaks
2. Place markers at each peak
3. Split the item at the markers
The more familiar you are with Reagent’s available tools, the better results you’ll get.

​
Ask Questions

Reagent can answer questions about your project and file system:
  • “Is there an EQ used somewhere in this session?”
  • “The mix has a large amount of low-end, investigate whether any additional plugins are used for boosting the bass”
  • “Are there any items with duplicate names in this session or in the desktop folder?”

​
Copying a Chat

Click the Copy button in the top bar to copy the entire conversation to your clipboard as formatted text. This is useful for sharing workflows, saving instructions, or reporting issues.

​
Keyboard Shortcuts

Keyboard shortcuts can be found in Settings > Shortcuts within Reagent.