# Scripts

> Create, import, trust, edit, and run local scripts manually or through Agent Mode.

Canonical: https://getmrmr.com/manual/scripts
Last verified: 2026-07-03
Minimum app version: 0.45.0

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 `⌘` + `K` and search for **New Script**. The built-in editor supports metadata completion, syntax highlighting, save with `⌘` + `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.