morı
documentation

How to live with a memory spirit.

Everything you need to install Mori, wire up your AI provider, and make ⌥M a habit. Five minutes, start to finish.

Getting started

Mori is a menu-bar app — after install you’ll find a small leaf icon at the top-right of your screen, not a Dock icon. The core loop is:

  1. Select text in any app (a message, an email, a paragraph).
  2. Press ⌥M. The composer opens with your context already in it.
  3. Draft, rewrite, summarize, or recall — then copy or insert.

Install: download the beta from the download page, unzip, drag Mori.app to Applications, and open it. macOS will show a “could not verify” notice (the beta isn’t notarized yet) — click Done, then go to System Settings → Privacy & Security → Open Anyway and confirm. One time only. The six onboarding screens walk you through the rest.

Accessibility permission (System Settings → Privacy & Security → Accessibility) is what lets Mori read your selection and insert replies — only when you press the shortcut. You can skip it and paste context manually instead.

Setting up your AI key

Mori brings no server of its own — it drafts through your AI provider. In Preferences → AI:

  1. Choose a provider: OpenAI-compatible (OpenAI or any gateway with the same API) or Anthropic.
  2. Set the model — defaults are gpt-4o-mini and claude-3-5-sonnet-latest. A custom base URL is supported for gateways.
  3. Paste your key → Save key Test connection. “Connected” means you’re ready.

Your key is stored in the macOS Keychain, never in plain files. The first time Mori reads it, macOS may ask you to allow access — click Always Allow. You can also describe your writing tone (e.g. “warm, brief, a little playful”) and Mori will match it when drafting replies.

Shortcuts

  • ⌥M — the main shortcut. With text selected, it prepares your default action; with nothing selected, it opens the composer (prefilled from your clipboard if there’s text on it).
  • ⌥⇧M — the actions palette: type to filter, / to move, to apply an action to your selection in place.
  • ⌘↩ — generate, inside the composer.
  • ⌘C / ⌘I — copy / insert the draft.
  • Esc — close any Mori window.

Shortcuts are fixed in the beta; custom bindings are on the roadmap.

The composer

The floating window that opens on ⌥M. Four modes across the top:

  • Reply — drafts a response to the context, using your tone and any matching memories.
  • Rewrite — makes the text clearer and more natural, preserving meaning.
  • Summarize — turns long text into short, useful notes.
  • Recall — answers a question from your saved local memories only.

The context box fills from your selection automatically, or use Paste / Read selection. Every draft is editable before you Copy, Insert (pastes into the app you came from), or Save to Memory. If inserting isn’t possible in the target app, Mori copies instead and says so.

Actions

Actions are one-keystroke transformations. Mori ships with eight: Rewrite, Fix spelling & grammar, Make shorter, Make clearer, Make friendlier, Make professional, Summarize, and Draft reply.

In Preferences → Actions you can enable, reorder, and create your own — a name, an icon, and a plain instruction like “Translate to Spanish” or “Turn into bullet points.” Built-ins can’t be edited, but you can duplicate one and customize the copy. The Test Action button runs any action on a sample so you can check the result before trusting it with real text.

Pick which action ⌥M runs in Preferences → General → Quick Action. By default Mori previews in the composer before inserting; turn off “Show composer before inserting” for instant in-place replacement.

Memory

Memories are small local notes — a saved draft, a selection, a fact you want Mori to recall later. They live in a JSON file on your Mac (~/Library/Application Support/Mori/), and nothing syncs anywhere.

  • Save from the composer (“Save to Memory”) or create notes directly in the Memory Library.
  • Recall mode searches them by keyword and answers only from what it finds.
  • Manage in Preferences → Memory: open the library, export/import JSON backups, reveal the file in Finder, or delete everything (with confirmation).

Privacy controls

Mori is user-triggered by design — no keylogging, no background capture, no screen recording. In Preferences → Privacy:

  • Pause Mori — temporarily stop it from using selection or memory.
  • Selected-text capture — turn off to make Mori paste-only.
  • Require manual paste only — strictest mode.
  • Clear all local memories — one click, confirmed, gone.

When you generate, the context you chose (plus matched memories and your tone) goes to your selected provider over HTTPS with your key. Their data policy applies to that request. Full details on the privacy page.

Troubleshooting

  • “Mori Not Opened / could not verify” — macOS Gatekeeper on non-notarized betas, expected for now. Click Done, then System Settings → Privacy & Security → Open Anyway → confirm. (On macOS 15, the old right-click → Open trick no longer works — use Open Anyway.) Terminal alternative: xattr -d com.apple.quarantine /Applications/Mori.app
  • ⌥M doesn’t read my selection — check Accessibility is granted (Preferences → Privacy shows the status), and note some apps (certain web views, secure fields) don’t expose selections — paste instead.
  • Insert didn’t paste — some apps reject synthetic paste; Mori copies instead and tells you. ⌘V finishes the job.
  • “Failed” on Test connection — check the key, the model name, and (for gateways) the base URL. The error message shown is the provider’s own.
  • Keychain prompt after updating — the beta’s signature changes between builds, so macOS re-asks. Click Always Allow.
  • Still stuck? Get support — include the app you were using and what you expected.

Docs current as of Mori 0.1.0. Mori stores memories locally by default; AI processing depends on your selected provider and settings.