# mrmr Manual

> Complete customer manual for mrmr, a voice-first interface for Mac.

Canonical: https://getmrmr.com/manual
Machine-readable index: https://getmrmr.com/manual/search-index.json

This document contains every current manual page in reading order. Individual Markdown pages are linked below for targeted retrieval.

# Contents

## Start here

- [Getting started](https://getmrmr.com/manual/getting-started.md): Install mrmr, grant the required permissions, connect an app, and try both voice modes.

## Dictation

- [Dictation](https://getmrmr.com/manual/dictation.md): Dictate into any Mac app, use hands-free recording, cancel safely, and recover your latest transcript.
- [Customize your dictation](https://getmrmr.com/manual/dictation/customize.md): Choose a microphone, control AI polish, set writing styles, and improve recognition of important terms.

## Agent Mode

- [Agent Mode](https://getmrmr.com/manual/agent-mode.md): Talk to mrmr, search connected work, run actions safely, and review completed agent sessions.
- [Sub-agents](https://getmrmr.com/manual/sub-agents.md): Delegate longer tasks, follow progress, approve external changes, and continue after completion.

## Apps and automation

- [Connect your apps](https://getmrmr.com/manual/integrations.md): Connect, reconnect, inspect, and disconnect the apps that Agent Mode can use.
- [Supported apps and commands](https://getmrmr.com/manual/integrations/supported-apps.md): See which apps mrmr currently supports and the kinds of voice commands available for each one.
- [Scripts](https://getmrmr.com/manual/scripts.md): Create, import, trust, edit, and run local scripts manually or through Agent Mode.

## Library and activity

- [Transcripts](https://getmrmr.com/manual/library/transcripts.md): Search saved dictations, copy text, switch between original and polished text, and manage recordings.
- [Dictionary](https://getmrmr.com/manual/library/dictionary.md): Teach mrmr names and jargon, define replacements, move entries between Macs, and control sync.
- [Activity and run history](https://getmrmr.com/manual/library/activity.md): Understand the Home dashboard and find previous Agent Mode, sub-agent, and script runs.

## Settings and account

- [Settings and shortcuts](https://getmrmr.com/manual/settings.md): Find every major preference for startup, overlays, microphones, voice modes, feedback, and updates.
- [Privacy, data, and account](https://getmrmr.com/manual/settings/privacy-account.md): Control saved transcripts, dictionary sync, connected apps, analytics, devices, and account deletion.

## Help

- [Troubleshooting](https://getmrmr.com/manual/troubleshooting.md): Fix common problems with permissions, microphones, text insertion, integrations, Agent Mode, and updates.

---

# Getting started

> Install mrmr, grant the required permissions, connect an app, and try both voice modes.

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

mrmr is a voice-first Mac app with two main modes:

- **Dictation** turns speech into polished text in whichever app has your cursor.
- **Agent Mode** listens to a request and can find information or take approved action across your connected apps and Mac.

## Getting access

mrmr is currently available by invitation only. To request access, email [h+access@getmrmr.com](mailto:h+access@getmrmr.com?subject=[mrmr]%20Access%20Request) and we'll get you set up.

## Complete setup

When you first open mrmr, the setup flow walks through five steps:

1. Sign in or create your account.
2. Review Dictation and Agent Mode.
3. Grant **Microphone** and **Accessibility** access.
4. Connect at least one supported app.
5. Confirm or change your Agent Mode hotkey, then try a command.

Microphone access is required for both voice modes. Accessibility access lets mrmr detect its global shortcuts and insert dictated text into other apps.

You can review either permission later under **General → Permissions** in mrmr. macOS permission changes happen in **System Settings → Privacy & Security**.

## Try Dictation

1. Put your cursor in any editable text field.
2. Hold `Fn` and speak.
3. Release `Fn` when you finish.

mrmr transcribes, polishes, and inserts the text at your cursor. The default Dictation hotkey is `Fn`, but you can change it under **Voice → Dictation mode → Hotkey**.

[Learn more about Dictation](/manual/dictation).

## Try Agent Mode

1. Press `Fn` + `Shift`.
2. Ask for information or an action, such as “What is on my calendar today?”
3. Review any confirmation mrmr shows before it changes external data.
4. Press the hotkey again to close the session.

The displayed hotkey in your app is authoritative if you changed the default. Change it under **Voice → Agent mode → Hotkey**.

[Learn more about Agent Mode](/manual/agent-mode).

## Find your way around the app

The sidebar contains the main customer areas:

| Area | What it contains |
| --- | --- |
| **Home** | Dictation and Agent Mode usage activity |
| **Transcripts** | Saved dictations and their locally retained audio |
| **Dictionary** | Names, jargon, and spoken-word replacements |
| **Integrations** | Connected, available, and local apps |
| **Agents** | Agent conversations and delegated sub-agent runs |
| **Scripts** | Voice-invokable scripts and their run history |
| **General** | Overlay, startup, permissions, and Agent Folder settings |
| **Voice** | Microphone, hotkeys, languages, polish, and writing style |
| **Privacy** | Transcript storage, dictionary sync, integrations, analytics, and devices |
| **About** | Version, updates, release notes, feedback, and useful links |

Open the command palette with `⌘` + `K` to search for pages, settings, and common actions. Open the keyboard shortcut reference with `Shift` + `/`.

## Keep mrmr available

Under **General → Startup**, enable **Start at login** if you want the global voice shortcuts ready after signing in to your Mac. You can also choose whether mrmr remains visible in the Dock when its main window is closed.

---

# Dictation

> Dictate into any Mac app, use hands-free recording, cancel safely, and recover your latest transcript.

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

Dictation records while you hold its hotkey, turns your speech into text, applies your selected polish and writing style, and inserts the result at the current cursor.

## Dictate into an app

1. Click the text field where the result should appear.
2. Hold your Dictation hotkey. The default is `Fn`.
3. Speak naturally. The overlay shows that mrmr is listening and, when enabled, previews words as they arrive.
4. Release the hotkey to finish.

Very short accidental taps are discarded. A recording warns at two minutes and stops automatically at five minutes.

## Use hands-free mode

Use either method:

- Double-tap your Dictation hotkey.
- While holding the hotkey and dictating, tap `Space`.

The recording stays active after you release the hotkey. Press the Dictation hotkey again to finish, or cancel from the overlay.

## Cancel a recording

Press `Esc` while recording or processing. Cancelling prevents the current result from being inserted.

## If text cannot be inserted

mrmr uses macOS Accessibility access to paste at your cursor. If the focused app changes or insertion is not safe, mrmr copies the result to the clipboard instead. Paste it manually with `⌘` + `V`.

Check **General → Permissions → Accessibility** if insertion repeatedly fails.

## Paste the latest transcript again

Use the **Paste last transcript** shortcut shown under **Voice → Dictation mode**. The default is `⌘` + `Control` + `V`, and it can be changed.

## Recording controls

Open **Voice → Dictation mode** to configure:

- **Hotkey** — the keys held to dictate.
- **Live preview** — show recognized words while speaking.
- **Mute while recording** — silence other apps during dictation and restore them afterward.
- **Auto-submit after dictation** — press Return immediately after inserting text.
- **Paste last transcript** — change the recovery shortcut.

Auto-submit should be used carefully. It submits the polished result before you can review it, and Return inserts a newline rather than submitting in many editors.

## Languages

Under **Voice → Languages**, select the languages you dictate in. Selecting one language locks recognition to it; selecting multiple keeps those languages available. mrmr preserves the language and script of your speech when polishing.

## Audio feedback

Under **Voice → Feedback**, you can enable or disable start/stop sounds and trackpad haptics. These settings do not change transcription behavior.

---

# Customize your dictation

> Choose a microphone, control AI polish, set writing styles, and improve recognition of important terms.

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

Most dictation controls live on the **Voice** page. Dictionary terms live on the separate **Dictionary** page.

## Choose and test a microphone

Open **Voice → Microphone**.

- **Select microphone** uses a specific input or automatically follows the Mac default.
- **Microphone sensitivity** boosts quiet input or soft speech.
- **Test your microphone** shows the current input level with your selected sensitivity.

If a selected microphone is disconnected, mrmr returns to automatic selection.

## Choose a polish level

Open **Voice → Polish**. The selected level applies across apps.

| Level | Result |
| --- | --- |
| **None** | Inserts the raw transcript, including fillers and mistakes |
| **Light** | Removes fillers and fixes grammar |
| **Medium** | Edits for clarity and concision; this is the default |
| **High** | Rewrites more freely for brevity and polish |

When polishing changes a saved transcript, mrmr retains both versions. Hover over it on **Transcripts** and choose **Undo AI edit** or **Redo AI edit**.

## Set writing styles by context

Open **Voice → Writing Style** to control capitalization, punctuation, and formatting for different contexts.

Basic mode groups apps into **Personal**, **Work**, **Email**, and **Other**. Advanced mode provides more specific app categories. Each category can use a **Formal**, **Casual**, or **Very Casual** tone.

Pin an installed app to a category when automatic categorization does not match how you use it.

## Add important words

Use **Dictionary** for names, product terms, technical vocabulary, or a phrase that should always become different text.

An entry can contain:

- A term mrmr should recognize.
- An optional replacement for how it should appear.
- A case-sensitive option.

Dictionary terms help recognition and are also applied after polishing. See [Dictionary](/manual/library/dictionary) for bulk add, import, export, and sync.

## How context helps

mrmr can use the active app, nearby text, clipboard context, writing-style settings, dictionary entries, and connected-workspace names to improve recognition and formatting. Sensitive fields such as passwords are excluded from captured context.

---

# Agent Mode

> Talk to mrmr, search connected work, run actions safely, and review completed agent sessions.

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

Agent Mode is mrmr's conversational voice interface. It can answer questions, search connected work, use public web information, control supported Mac functions, run scripts, and take action in connected apps.

## Start a session

1. Press your Agent Mode hotkey. The default is `Fn` + `Shift`.
2. Speak your request normally.
3. Continue the conversation if mrmr needs clarification.
4. Press the hotkey again to close the session.

The floating panel stays above your current work without taking keyboard focus. Change the hotkey and speaking voice under **Voice → Agent mode**.

## Ask effective commands

State the desired outcome and include the details you already know:

- “Send the design channel a message that review starts at 2.”
- “What is on my calendar tomorrow afternoon?”
- “Create a Linear bug for the mobile login crash and assign it to me.”
- “Find recent public information about the company and summarize it.”
- “Pause my music.”

For names such as channels, people, projects, lists, or calendars, mrmr uses connected workspace data to find the relevant item. It may ask you to choose when multiple matches are plausible.

## Reads and writes

Read-only actions, such as listing calendar events or searching messages, can return immediately.

Actions that send, create, update, delete, or otherwise change data require confirmation. Review the confirmation card, then approve or reject it. mrmr will not treat silence as approval.

## Results in the panel

Short results can be spoken. Lists, tables, schedules, and longer answers can appear as formatted content in the expanded panel while mrmr speaks a brief summary.

## Supported capabilities

Agent Mode can use:

- Connected cloud apps from **Integrations**.
- Apple Reminders, after granting local permission.
- Public web search and supported browser search.
- Supported system actions, such as opening an app or controlling media.
- Trusted scripts from your Agent Folder.
- Sub-agents for longer, self-contained tasks.

Availability depends on the connected app and the permissions granted to it.

## Review previous sessions

Open **Agents → Agent Runs**. Each completed session can show:

- The conversation transcript.
- Tools that were used.
- Approved or rejected writes.
- Delegated work.
- A formatted result and usage details when available.

## Usage limits

Dictation is unlimited. Agent Mode includes up to 60 minutes of active agent response time per day and 10 hours per month. Open **Account** from your profile in the sidebar to see remaining daily and monthly usage.

The meter counts active response generation, not the full amount of time that the Agent Mode window is open.

---

# Sub-agents

> Delegate longer tasks, follow progress, approve external changes, and continue after completion.

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

Sub-agents handle longer, self-contained work in the background while you continue using your Mac. They can research, read connected-app data, and prepare or perform multi-step work.

## Delegate a task

Ask Agent Mode to delegate a clearly bounded outcome. For example:

- “Delegate a review of my open Linear issues and group them by priority.”
- “Research this company, summarize the findings, and draft a Notion note.”
- “Compare my calendar with the launch tasks and identify scheduling risks.”

Include relevant constraints, expected output, and the apps the task may use.

## Follow progress

Open **Agents → Sub-agents**. Runs show one of these states:

- **Queued** or **Working** — the task is still progressing.
- **Needs approval** — a proposed external change is waiting for you.
- **Done** — the result is available.
- **Failed** — the run could not complete.

Select a run to open its floating panel and inspect its activity.

## Approve a write

Sub-agents can perform reads while working. Before they send, create, update, or delete data, the run pauses and displays the proposed action.

Approve to perform that action or reject to continue without it. A task may pause more than once if it proposes multiple writes at different stages.

## Continue the conversation

After a run finishes, send a follow-up message from its panel to refine the answer or ask a related question. The original task, result, and prior follow-ups remain available to the run.

## When to use Agent Mode instead

Use the live Agent Mode conversation when:

- You expect quick clarification or several choices.
- You want an immediate read or a single action.
- You want to remain actively involved at every step.

Use a sub-agent when the work has a clear endpoint and may require several searches or tool calls.

---

# Connect your apps

> Connect, reconnect, inspect, and disconnect the apps that Agent Mode can use.

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

Connected apps allow Agent Mode and sub-agents to search information and perform approved actions. Workspace names can also improve dictation recognition for people, projects, channels, and other proper nouns.

## Connect a cloud app

1. Open **Integrations**.
2. Select the **Available** tab.
3. Find the app and open its card.
4. Review the capabilities and example commands.
5. Choose **Connect** and complete the provider's authorization flow.
6. Return to mrmr when authorization finishes.

The app moves to the **Connected** tab. Initial workspace information can take a short time to become available.

## Connect Apple Reminders

Apple Reminders is a local Mac integration rather than a cloud OAuth connection.

1. Open **Integrations → Local apps**.
2. Select **Apple Reminders**.
3. Choose **Connect Apple Reminders**.
4. Approve the macOS permission prompt.

mrmr can then create, read, complete, and organize reminders through Agent Mode.

## Limited access

An integration marked **Limited access** connected successfully but is missing a permission required for supported actions. Open its card and reconnect, then grant the requested access on the provider's consent screen.

## Disconnect an app

Open the connected app's card and choose **Disconnect**. To revoke all cloud integrations together, open **Privacy → Disconnect all integrations**.

Disconnecting removes mrmr's access. You must authorize the app again before Agent Mode can use it.

Apple Reminders is disconnected separately from **Integrations → Local apps**.

## Connection safety

Connecting an app makes its supported tools available to mrmr; it does not pre-approve changes. Agent Mode and sub-agents still ask for confirmation before write actions.

See [Supported apps and commands](/manual/integrations/supported-apps) for the current integration list.

---

# Supported apps and commands

> See which apps mrmr currently supports and the kinds of voice commands available for each one.

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

The exact action available can depend on your account, workspace, and granted provider permissions. Write actions require confirmation.

## Messaging and project work

### Slack

Send, schedule, and search messages; manage status and Do Not Disturb. Try “DM Priya that the release is live” or “Search Slack for the launch checklist.”

### Linear

Create, update, assign, and comment on issues across teams and projects. Try “Create a bug for the mobile login crash” or “List my open issues.”

### GitHub

Work with issues, pull requests, reviews, merges, and CI status. Try “Any open pull requests waiting on my review?”

### Notion

Search and read pages, create content, work with database rows, and add comments. Try “Add a note to my meeting notes page.”

## Email and planning

### Gmail

Send, reply, search, and triage email. Try “Any unread emails from this morning?” or “Email Sarah that the deck is ready.”

### Google Calendar

Review, create, move, and cancel events and find free time. Try “What is on my calendar today?”

### Google Tasks

Create, complete, move, and organize tasks and task lists. Try “Add a task to send the proposal by Friday.”

### Apple Reminders

Create, read, complete, and organize reminders locally on your Mac. Try “Remind me to call the dentist tomorrow at 10.”

## CRM

### Attio

Create and update people, companies, deals, notes, and tasks. Try “Add a note to Acme that the proposal goes out Friday.”

## Scheduling and meetings

### Cal.com

Review bookings, find open slots, and manage scheduling and availability. Try “What are my Cal.com bookings this week?”

### Calendly

Review and cancel meetings, create scheduling links, and check availability. Try “Create a scheduling link for my 30-minute intro.”

### Google Meet

Create meeting links, schedule calls, and look up supported past-meeting information. Try “Start an instant Google Meet.”

### Zoom

Create instant, scheduled, or recurring meetings and retrieve supported meeting information. Try “Schedule a Zoom with marketing Thursday at 3.”

## Find the current list in mrmr

Open **Integrations → Available**. This page is the authoritative list for the version installed on your Mac. Each card shows its current capabilities and example commands before you connect it.

---

# 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.

---

# Transcripts

> Search saved dictations, copy text, switch between original and polished text, and manage recordings.

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

When **Privacy → Save transcripts** is enabled, completed dictations appear on the **Transcripts** page and are stored locally on your Mac.

## Use transcript history

Open **Transcripts** from the sidebar. You can:

- Search saved text.
- Copy a transcript to the clipboard.
- Delete one transcript.
- Download its retained audio as a `.webm` file when audio is available.
- Undo or redo the AI edit when both original and polished text were retained.

Hover over a transcript to reveal its actions.

## Original and polished text

If polishing changed a transcript, **Undo AI edit** switches the displayed text back to the original transcription. **Redo AI edit** restores the polished version. This does not re-run the polishing model.

## Local audio storage

When transcript saving is enabled, mrmr can retain the corresponding recording locally with the transcript. Open **Privacy → Save transcripts → Open folder** to view the recordings folder in Finder.

Deleting an individual transcript also deletes its associated audio file. Clearing transcripts removes the complete local history and recordings directory.

## Disable transcript saving

Open **Privacy** and turn off **Save transcripts**. Confirming this action permanently deletes existing saved transcripts and associated local recordings. New dictations are still processed and inserted, but they are not added to transcript history.

The **Transcripts** sidebar item is hidden while saving is disabled.

---

# Dictionary

> Teach mrmr names and jargon, define replacements, move entries between Macs, and control sync.

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

The Dictionary improves recognition of names, jargon, acronyms, and technical terms. It can also replace a spoken form with the exact text you want inserted.

## Add an entry

1. Open **Dictionary**.
2. Enter the word or phrase mrmr should listen for.
3. Optionally add the replacement that should appear in the final text.
4. Enable case sensitivity only when capitalization must match exactly.
5. Add the entry.

Examples:

| Spoken or recognized term | Replacement |
| --- | --- |
| `mr mr` | `mrmr` |
| `kubernetes` | Leave blank; use it only as recognition vocabulary |
| `acme cloud` | `ACME Cloud` |

Duplicate terms are not added. The app displays the current entry count and limit at the top of the page.

## Edit, search, and delete

Search checks both terms and replacements. Hover over an entry to edit or delete it. Keyboard users can press `E` to edit the hovered entry or `Backspace` to delete it.

## Bulk add

Open the Dictionary menu and choose **Bulk add**, or press `⌘` + `B`. Bulk add is useful when many specialist words do not require replacements.

## Import and export

Use the Dictionary menu to:

- **Import** a dictionary JSON file.
- **Export** the current entries to `mrmr-dictionary.json`.
- **Clear dictionary** after confirmation.

The menu displays shortcuts for these operations.

## Sync across devices

Dictionary entries are local by default. Enable **Sync across devices** from the Dictionary menu or the **Privacy** page to keep them synchronized through your mrmr account.

Disabling sync deletes the server copy while keeping local entries. Clearing the dictionary deletes the entries themselves.

## How entries are applied

Dictionary information helps speech recognition, informs polishing, and applies exact replacements after polishing. This layered approach helps preserve important spelling even when AI polish is enabled.

---

# Activity and run history

> Understand the Home dashboard and find previous Agent Mode, sub-agent, and script runs.

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

mrmr separates activity into several pages based on the feature that created it.

## Home activity

Open **Home** to review dictation and Agent Mode activity over the selected period. Home requires **Share usage analytics** to be enabled; if it is off, the page offers a button to enable it.

The dashboard summarizes activity such as dictation usage and agent activity. Available periods can be changed from the control in the page header.

## Agent Runs

Open **Agents → Agent Runs** to review completed live voice sessions. Select a run to inspect its conversation, tool activity, result, and usage details.

## Sub-agent history

Open **Agents → Sub-agents**. Select a run to reopen its panel, inspect progress, respond to an approval request, or send a follow-up after completion.

## Script run history

Open **Scripts → Runs** for scripts launched manually or by Agent Mode. Long-running scripts also appear here after the initial command returns.

## Dictation history

Open **Transcripts** for the actual saved text and recording associated with each dictation. Transcript storage is controlled separately from usage analytics under **Privacy → Save transcripts**.

## Usage allowance

Open your profile from the sidebar to reach **Account**. The Usage section shows remaining daily and monthly Agent Mode time. Dictation does not consume this allowance.

---

# Settings and shortcuts

> Find every major preference for startup, overlays, microphones, voice modes, feedback, and updates.

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

Settings are divided between **General**, **Voice**, **Privacy**, **About**, and **Account**.

## General

### Overlay

- **Show mrmr overlay at all times** keeps the recording overlay visible while idle.
- **Demo mode** displays “Dictating with mrmr” while the app is in use.

### Startup

- **Start at login** opens mrmr when you sign in to your Mac.
- **Show app in Dock** keeps mrmr in the Dock after its main window closes.

### Permissions

Review Microphone and Accessibility access and open the relevant macOS controls when permission is missing.

### Agent Folder

Open or change the folder mrmr watches for local scripts.

## Voice

The Voice page contains:

- Microphone selection, sensitivity, and input testing.
- Agent Mode hotkey and speaking voice.
- Dictation hotkey, live preview, recording mute, auto-submit, and paste-last shortcut.
- Dictation languages.
- Sound and trackpad feedback.
- Writing styles by app context.
- None, Light, Medium, and High polish levels.

See [Customize your dictation](/manual/dictation/customize) for details.

## About and updates

Open **About** to see and copy the installed app version, check for updates, toggle automatic updates, read **What's New**, send feedback, or open mrmr links.

The sidebar also shows update status and provides a quick update action.

## Command palette

Press `⌘` + `K`. Search for a page, change common settings, manage dictionary data, disconnect integrations, open the Agent Folder, create or import scripts, check for updates, send feedback, or open this manual.

Some destructive commands display a confirmation dialog.

## Keyboard shortcut reference

Press `Shift` + `/` or select the keyboard icon at the bottom of the sidebar. The searchable dialog shows current voice hotkeys along with navigation, dictionary, and general app shortcuts.

Voice hotkeys shown there update when you change them under **Voice**.

---

# Privacy, data, and account

> Control saved transcripts, dictionary sync, connected apps, analytics, devices, and account deletion.

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

Open **Privacy** for data controls and open your profile in the sidebar for **Account**.

## Saved transcripts and recordings

**Save transcripts** stores completed dictations locally and makes the **Transcripts** page available. Associated audio may also be retained locally and can be opened or downloaded.

Turning this setting off permanently deletes existing saved transcripts and recordings. Use **Clear transcripts** to erase them without disabling future history.

See [Transcripts](/manual/library/transcripts).

## Dictionary sync

**Sync across devices** stores a server copy of dictionary entries for your signed-in Macs. Disabling sync deletes the server copy but retains local entries. **Clear dictionary** deletes the entries themselves.

## Connected apps

**Disconnect all integrations** revokes all connected cloud apps. Apple Reminders is a local integration and is managed separately under **Integrations → Local apps**.

## Usage analytics

**Share usage analytics** controls anonymous feature-usage and app-performance reporting. The app states that this reporting does not include your audio, transcriptions, or messages.

Home activity statistics require this setting to be enabled.

## Devices

The Privacy page includes your signed-in device information and available device-management controls. Review this section if you no longer recognize or use a listed Mac.

## Account and Agent Mode usage

Open your profile to reach **Account**. You can review account details, manage authentication options, see daily and monthly Agent Mode allowance, sign out, or deactivate the account.

## Deactivate your account

Deactivation permanently deletes the account and associated server data. mrmr also clears user-specific local data, including transcript history, recordings, dictionary entries, settings, and saved authentication. Read the confirmation dialog carefully before proceeding.

---

# Troubleshooting

> Fix common problems with permissions, microphones, text insertion, integrations, Agent Mode, and updates.

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

## mrmr does not start recording

1. Open **General → Permissions** and confirm Microphone and Accessibility are granted.
2. Open **Voice → Microphone** and run the input test.
3. Confirm the displayed Dictation or Agent Mode hotkey.
4. Check whether another app or shortcut utility is intercepting the same keys.
5. Quit and reopen mrmr after changing macOS permissions.

If microphone permission was previously denied, enable it manually in **System Settings → Privacy & Security → Microphone**.

## Dictated text is not inserted

- Confirm Accessibility access under **General → Permissions**.
- Keep the destination app and text field focused until processing finishes.
- Check the clipboard; mrmr copies the result there when focus changed or insertion was not possible.
- Use the **Paste last transcript** shortcut shown under **Voice → Dictation mode**.

## Recognition is inaccurate

- Select and test the correct microphone under **Voice**.
- Increase sensitivity for quiet speech, but reduce it if background noise becomes dominant.
- Limit **Languages** to the languages you actively dictate in.
- Add names and jargon to **Dictionary**.
- Connect relevant work apps so workspace names can help recognition.
- Reduce the polish level if the final wording is changing too much.

## A recording disappeared

Recordings shorter than approximately half a second are treated as accidental taps and discarded. Longer dictations are only retained in **Transcripts** when **Privacy → Save transcripts** is enabled.

## An integration will not connect

- Complete the provider's authorization in the browser and return to mrmr.
- If the card shows **Limited access**, reconnect and grant all requested permissions.
- Confirm you authorized the intended provider account or workspace.
- Disconnect the app, then connect it again if the authorization is stale.

Apple Reminders uses a macOS permission rather than browser authorization. Manage it from **Integrations → Local apps** and macOS Privacy & Security settings.

## Agent Mode cannot perform an action

- Confirm the required app is connected under **Integrations**.
- Use the product name in your request when the target could be ambiguous.
- Provide a channel, project, list, calendar, or recipient name.
- Respond to any choice or confirmation card before continuing.
- Check remaining usage under **Account**.

The connected provider may not expose every action, and account permissions can restrict otherwise supported tools.

## A sub-agent is waiting

Open **Agents → Sub-agents**. A **Needs approval** badge means the task proposed a write and is paused until you approve or reject it.

## A script will not run

- Open **Scripts** and confirm the script is trusted.
- Review required arguments.
- Verify the file remains inside the configured **General → Agent Folder**.
- Run it manually to inspect its result.
- Check **Scripts → Runs** for a long-running or failed execution.

## mrmr will not update

Open **About** and choose **Check now**. You can also use the update control at the bottom of the sidebar. Confirm the Mac is online and reopen mrmr if an already-downloaded update is waiting to install.

## Get support

Open **About → Send Feedback**. When reporting a technical issue, include recent app logs only if you are comfortable sharing them; the feedback dialog lets you choose whether to attach logs.