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