Skip to main content
Describe what you want in plain words, and Reagent reads your REAPER project, runs the tools it needs and tells you what it did. To read or change your project, it needs the Bridge running in REAPER.

​
Sending Messages

Type your request and press Enter to send, or Shift+Enter for a new line. Ask for changes, or ask about your project or files in folders Reagent can reach:
For tips and more examples, see Best Practices. Type / to run a saved slash command. Pastes over 10 lines collapse into a “Script pasted · N lines” block that you can expand or remove before you send. A paste too large to send is turned away with a message, not cut short.

​
Reference Selections

Refer to what’s selected in REAPER, or in Wwise when it’s connected:
Reagent can also look up other parts of the project, such as regions, when you mention them. See Working with Selections for how “this” and “these” are matched.

​
Following Reagent’s Work

Each run of tool steps folds into a summary line:
  • While Reagent works, the line names the step in progress (“+N more” when several run at once) and shows a timer, such as “Running for 12s”.
  • When it’s done, the line sums up the steps, such as “Ran 6 tools”, and the reply ends with “Worked for 1m 35s”.
  • Click the line to see each step, with its details and results.
Reagent loads more tools or a skill when a task needs them. These Load tools and Load skill steps don’t change anything in REAPER, Wwise or your files. Before a step that changes your project or files, Reagent may ask on an approval card, depending on your permission mode. If a step fails, the summary line says so, for example “Ran 6 tools (1 failed)”. Open it to see the problem, sometimes a suggested next step (→), and Show details for the technical error. Reagent sees the error and can try another way. If it keeps failing, stop the reply and describe the task differently. If a whole reply fails, see Chat Problems. For endpoint errors, see Custom Endpoint troubleshooting.

​
Stopping a Reply

To stop a reply, click the stop button (Cancel request) that replaces the send button, or press Esc. You can’t type in the message box while Reagent works, so stop the reply to change course.
  • Stopping doesn’t undo changes already made. Check your project, and see Undoing Changes.
  • Stopping doesn’t give credits back, including for the step that was running. See Plans and Credits.

​
Answering Reagent’s Questions

When Reagent needs a decision, a question card replaces the message box. If the Reagent window isn’t in front, you get a desktop notification: “Reagent needs your input”. Click an option or press its number, type your own answer in Something else, or, when several are allowed, tick them and click Submit. For every card key, see Keyboard Shortcuts.

​
Cancelling an Agent Question

Click the X at the top of the card, click Cancel next to Something else (on single-choice questions), or press Esc. While you’re typing in Something else, Esc clears your text instead. Reagent stops instead of guessing, and the cursor moves to the message box so you can redirect it.

​
Attaching Files

Attach a screenshot, a CSV of new names, a PDF brief or other files for Reagent to work from:
  • Click + in the message box and choose Attach file, Attach image or Attach folder, or drag files or folders onto the message box.
  • Paste an image, such as a screenshot, from the clipboard.
  • Paste a file’s full path on its own, without quotation marks (on Windows, remove the ones Copy as path adds). ~/ isn’t recognized. A pasted path to a GIF, HEIC or HEIF image is turned away. A pasted path to any other unsupported or missing file stays in your message as text.
For an attached folder, Reagent gets its path, not its contents. It can use its file tools on the files inside if the folder is within reach. You can attach up to 10 files per message, and up to 8 MB per image, text file or PDF. Files turned away, for example for their type or size, are reported in a pop-up and aren’t added. Each request to Reagent’s service has a size limit for attachments plus the conversation so far. Reagent warns you before you go over and lets you remove a file. A file that fails to upload shows “name could not be attached. Remove it to send this message.” and blocks sending until you remove it.

​
Where Attachments Go

  • Individual plans: attachments go to the AI model through Reagent’s service. PDF, TXT, CSV, TSV, Word and Excel files are also uploaded to Reagent’s servers when you attach them, so the dialogue tools can use them as a reference script. See Documents You Attach.
  • Enterprise accounts: images, PDFs and text files go to your organization’s model. Reagent doesn’t upload reference files to its servers for Enterprise accounts, so Word and Excel files are turned away. To work from a spreadsheet, save it as CSV or TSV. If your organization’s model doesn’t take pictures, images are turned away too, with a message that says so.

​
Managing Chats

Earlier chats are in the sidebar, grouped into Starred, Today, Yesterday, Previous 7 days and Older.
  • New chat: click New chat in the sidebar, or press Cmd+N (macOS) or Ctrl+N (Windows). A new chat doesn’t remember earlier chats or their results, such as analysis, so finish a multi-step job before you switch. See when to start one.
  • Search: type in Search chats to filter by title.
  • Star: hover a chat and click the star icon, or use its ⋯ menu. Starred chats stay at the top.
  • Rename or edit: Reagent names each chat automatically. You can’t rename a chat or edit a sent message. Send a new message instead.
  • Delete: in the ⋯ menu, choose Delete (one chat) or Clear all (every chat), then confirm. You can’t restore a deleted chat in the app.
Reagent saves your chats automatically on this computer: they don’t sync to your account or other computers, signing out doesn’t delete them, and anyone who opens Reagent with the same macOS or Windows user account can see them, even signed in to a different Reagent account. On a shared computer, use your own user account (Privacy & Security).
Run one chat at a time. You can send in a second chat while the first is still working, but both would change the same REAPER project at once. Let the reply finish, or stop it, before you use another chat.

​
Long Chats and the Context Ring

After Reagent’s first reply, a ring next to the send button shows how much of the model’s context window (how much of the conversation it can take in at once) is used. Hover over it to see “N% context used”. It turns amber at 80% and red at 95%. When a chat gets long, Reagent summarizes older turns for the model and adds a divider: “Earlier context summarized … Everything above is still here.” You still see the whole chat, but Reagent may no longer recall fine details from far back, so start a new chat if they matter. The ring and the summaries follow the Context window set for your organization’s endpoint.

​
Copying a Chat

Click Copy chat in the title bar to copy the whole conversation as Markdown. To copy one of your messages, hover over it and click Copy message.