Skip to main content
Good candidates include a Wwise audit, a render check or a UCS naming pass.

​
Create a Command

1

Open the form

Open Settings by clicking your name at the bottom of the sidebar and choosing Settings, or press Cmd+, / Ctrl+,. Go to Commands and click New command.
2

Enter a name

In Name, type a short name such as ucs-check. This is what you type after / in chat. See Naming Rules.
3

Write the instructions

In Instructions, write what you want Reagent to do, as you’d type it in chat. Line breaks are fine. See Example Command.
4

Save

Click Save or press Cmd+S / Ctrl+S. The command now appears on the Commands page.
Save before you leave the form. Only Cancel and Esc ask “Discard changes?” first. Any other way out, such as clicking another Settings tab or starting a new chat, loses unsaved changes without asking.

​
Naming Rules

Reagent tidies the name as you type: it lowercases it, turns spaces into hyphens, merges repeated hyphens, drops other characters and cuts it at 64 characters. If Save stays greyed out, see Troubleshooting.

​
Example Command

Write a command like a clear chat message: what to look at, what to do, and when to stop and ask you. A command named ucs-check could contain:
A command can also ask for the Wwise subagent, such as “Ask the Wwise subagent to list events with no sound assigned.” The Wwise subagent is only available while Reagent is connected to Wwise.

​
Run a Command

Type / at the start of your message, or after a space or line break. A list of your saved commands opens above the cursor. There are no built-in commands, and skills don’t appear here because Reagent loads a skill on its own when your request needs one. / on its own shows all your commands in alphabetical order. Keep typing to narrow the list: part of a name or a small typo still matches. Reagent inserts the name and a space, and names that match a saved command turn bold. Add any extra instructions, then press Enter to send. You can mix commands with your own text and use several in one message. This example assumes you’ve saved commands named ucs-check and render-check:

​
What Happens When You Send

Reagent swaps each recognized command for its saved instructions and keeps the rest of your message as you typed it. Everything goes out as one normal message. There’s no separate command mode.
  • Your chat shows the short version (/ucs-check). Reagent keeps the full text with the message, and that’s what the model sees.
  • Edits apply from your next message. Reagent reads the saved instructions each time you send. Messages you already sent keep their original text.
  • Commands are text, not settings. A command doesn’t change your permission mode, the model or the tools Reagent can use.
If a command asks for something your plan doesn’t include, the message still sends but Reagent can’t do that part (see Feature Availability).

​
Edit or Delete a Command

On Settings > Commands:
  • Edit: click the command’s name or Edit to change its name or instructions. After a rename, only the new name works in chat.
  • Delete: click the trash icon on the command’s row, or open the command and click Delete. Then confirm in the dialog, for example “Delete /ucs-check?”. This removes the file from your computer and can’t be undone.
Changes you make here show up in the / list straight away.

​
Where Commands Are Stored

Each command is a plain Markdown file named after it, such as ucs-check.md, holding only the instructions. The files live in a commands folder inside Reagent’s app data folder. Click Open in Finder on the Commands page to open the app data folder with commands selected. The button has the same label on Windows, where it opens File Explorer. Copying the commands folder is an easy backup. You can also add or edit these files yourself:
  • Name the file after the command, following the naming rules, and end it in .md. Files with other names don’t appear in Reagent.
  • Everything in the file is sent as is, including headings or notes to yourself. Keep only what you want the model to read.
  • Reagent picks up files you add, rename or delete the next time you open Settings > Commands or restart Reagent.

​
Copy to Another Computer

Commands belong to the computer, not your Reagent account, and aren’t synced, so a second computer starts with none. To copy them over:
  1. On the second computer, open Settings > Commands and click Open in Finder.
  2. Copy your .md files into the commands folder.
  3. Click another Settings tab and then Commands again, or restart Reagent.

​
Troubleshooting

Read the message under Name:
  • “Use lowercase letters, digits, and hyphens only”: the name starts or ends with a hyphen. This message also shows briefly while you type a name ending in a hyphen, such as ucs-, and goes away when you type the next word.
  • “A command with this name already exists”: another command uses this name. Choose a different one.
Reagent can’t open a command named new for editing. Avoid using new as a name.
While the / list is open, Enter inserts the highlighted command instead of sending. If you type a full command name and press Enter, the first press completes the name and the second sends.
Type / at the start of your message, or after a space or line break. Nothing appears until you’ve saved at least one command.
Reagent sends /name exactly as you typed it in these cases:
  • It isn’t a separate word. In SFX/ucs-check, /ucs-check. or /ucs-check, the name isn’t bold and isn’t recognized. Put a space after it or end the message with it.
  • No saved command has that name. A /word that matches no saved command is sent as typed.
  • You added the file outside Reagent. A new file’s /name is sent as ordinary text until you open Settings > Commands or restart Reagent.
  • The file was deleted outside Reagent. The command can still appear in the / list until Reagent picks up the change. Sending it shows “Command /name no longer exists — sent as text.”

Chat

Where you type and send commands.

Skills

Built-in workflows Reagent loads when a task needs them.

Permissions

Control what Reagent may change without asking.

Settings

Find the Commands page and every other setting.