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