mrmr does not start recording
- Open General → Permissions and confirm Microphone and Accessibility are granted.
- Open Voice → Microphone and run the input test.
- Confirm the displayed Dictation or Agent Mode hotkey.
- Check whether another app or shortcut utility is intercepting the same keys.
- 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.