Scripts let Agent Mode invoke your own local shell commands by voice. They live in your Agent Folder and include metadata that tells mrmr what the script does, which arguments it accepts, and how to handle its output.
Only run scripts you understand and trust. Scripts execute with your user account’s local permissions.
Find the Scripts page
Open Scripts from the sidebar. It has two tabs:
- Scripts — your available scripts.
- Runs — recent manual and Agent Mode executions, including longer background runs.
Create a script
Choose New Script, or open the command palette with Command + K and search for New Script. The built-in editor supports metadata completion, syntax highlighting, save with Command + S, and opening the file in your external editor.
Use Browse Scripts to start from the sample gallery.
Import from Raycast
Choose Import from Raycast to find compatible Raycast script commands. Imported scripts remain inactive until you inspect their source and explicitly trust them.
Trust is a security boundary, not a quality check. Review commands, network calls, file changes, and argument handling before enabling an imported script.
Script arguments
Scripts can declare positional arguments such as text, a dropdown choice, or a file. A manual run prompts you for required values. Agent Mode can fill arguments from your spoken request and ask when a required value is missing.
Output behavior
A script controls what happens to its output:
| Output | Behavior |
|---|---|
| Auto | Agent Mode decides how to use the result |
| Copy | Copies output to the clipboard |
| Paste | Inserts output at the current cursor |
| Render | Displays output in the agent panel |
| Open | Opens the resulting file or URL |
| Silent | Runs without visible output |
Copy, Paste, Open, and Silent are handled locally without sending their output back into the agent conversation.
Run by voice
Start Agent Mode and say the script’s title and required details, for example “Run my resize images script on the Downloads folder.” Scripts configured to require confirmation show an approval card before execution.
Long-running scripts can continue in the background. Follow them under Scripts → Runs.
Change the Agent Folder
Open General → Agent Folder to view, open, or change the folder mrmr watches for scripts. Changing it affects which scripts appear in the app and Agent Mode.