The Guide

What is Mori

Mori is a desktop AI agent that actually does things. She lives on your Mac and Windows machine, sees your screen, drives your mouse and keyboard, browses the web in your real signed-in Chrome, writes and runs code, preps trades, and talks to you out loud.

Unlike a chat box, Mori operates your real machine end-to-end. You give her a goal in plain language; she picks the right tool and carries it out — while you keep your hand on anything that spends money.

Install

Mori ships for macOS (Apple Silicon, macOS 13+) and Windows 10/11 (64-bit). Both installers are code-signed; the Mac build is notarized and stapled by Apple, so it opens with a normal double-click — no right-click dance, no warnings.

macOS    Download StudioMori.dmg → open → drag Mori to Applications → launch
Windows  Download StudioMori-Setup.exe → run → desktop + start-menu shortcuts

Terminal install

Prefer the command line? One line gets you Mori — same app, no browser needed.

macOS

curl -fsSL https://studiomori.ai/install.sh | sh

Windows

irm https://studiomori.ai/install.ps1 | iex

Each script fetches the latest build and installs it in one pass. When it finishes, open Mori and pick up at Quick start below.

Permissions

For Mori to see and control your computer, macOS needs two grants. She'll prompt you on first use:

Screen Recording

Lets Mori see your screen so she can act on what's there. System Settings → Privacy & Security → Screen Recording → enable Mori, then relaunch.

Accessibility

Lets Mori move the mouse and type. System Settings → Privacy & Security → Accessibility → enable Mori.

Operating your real Chrome (optional)

To shop and browse inside your already-signed-in Chrome, enable Chrome → View → Developer → Allow JavaScript from Apple Events, and approve the Automation prompt the first time.

Quick start

Once she's open:

1. 1Open Providers and paste an API key — pick one provider active.
2. 2Pick a model and hit Test connection.
3. 3Go to Chat and ask her something — “open Notes and write my grocery list.”
4. 4Watch her work; approve anything that costs money.

How API keys work

Mori doesn't resell AI. You bring a key from a provider you already trust, and Mori routes chat, the agent loop, tools, coding, and computer-use through it. You only pay your provider for what you use.

Keys live in Mori's local settings on your machine. They are never uploaded to us. You can set one active provider and keep keys for others ready to switch.

Providers

Ten providers are built in — nine cloud APIs plus local models through Ollama. Add a key for any cloud provider in the Providers page, set one active, and test the connection; Ollama needs no key at all.

Models

Each provider exposes its own models. In the Providers page, hit fetch live to pull the current list straight from the provider, or type any model id. Mori always defaults to the newest flagship — e.g. Claude Opus 4.8 on Anthropic, Grok 4 on xAI.

Computer-use and shopping want a strong vision model; quick chat or coding can use a faster, cheaper one. You can switch any time without losing your work.

Local models (Ollama)

Run models entirely on your own machine — no key, no cloud, fully offline. Mori talks to Ollama at localhost:11434, and its OpenAI-compatible endpoint means everything — chat, tools, the agent loop — rides the same path as any cloud provider.

Pick Ollama in Providers and Mori auto-detects the models you've already pulled and lists them just like a cloud catalog; hit fetch live to refresh. Pull one first with a single command:

ollama pull llama3.2

Computer use

The headline feature. Mori takes a screenshot, the model decides the next action, and Mori performs it with a real OS-level click or keystroke — then repeats until the task is done. She streams what she sees back into the chat as photos so you can follow along.

Ask things like “use the computer to open Notes and write my list,” or “find the cheapest USB-C cable on Amazon and add it to my cart.” She works across any native app or website.

Browser engine

For web tasks Mori uses a fast DOM engine instead of pixels: she reads the page's interactive elements and clicks by selector — vastly faster than screenshots. She can run a private sandbox browser, or drive your real, already-signed-in Chrome so your logins just work.

Shopping & checkout

Mori compares real listings, adds the right item to your cart, and fills shipping & contact details all the way to the final order screen. Then she stops and shows you a clean review.

Coding & preview

Mori scaffolds whole projects — multi-file apps, not snippets — into a folder, opens them in a built-in Monaco editor, and shows a live preview window for web projects. She recovers from her own errors mid-build. (She once built a fully playable 2048 in one pass.)

Terminal

A real shell built in (xterm.js). Mori runs npm, git, build tools and dev servers with live streaming output, and cd state persists between commands. Destructive commands are gated behind a confirmation.

Voice & vision

Mori speaks with ElevenLabs TTS, sentence-by-sentence, with her mouth lip-synced to the audio. She also sees — screenshots of your screen and any image you hand her — so you can show her a photo and ask about it.

The living UI

You always know when Mori has the wheel. Whenever she's controlling your computer or the web, a soft blue glow frames the screen with a small “Mori is using your computer” banner. The moment she stops, it's gone.

The working indicator is genuine, too — it shows the real step she's on right now, not a looping spinner pretending to be progress. What you see is what she's actually doing.

The brain

The agent behind the face keeps getting sharper. Here's what that means in practice:

She remembers you

Mori carries memory across sessions — who you are, how you like things done, what you're working on — and consolidates it over time, so the important things stick while the noise fades. Everything she remembers is visible (and removable) in Settings → Memory.

She learns from her own work

Tasks that go well become playbooks she reaches for the next time something similar comes up. Tasks that go wrong become lessons — she remembers the mistake and steers around it.

She reads your files for real

Hand her a PDF and she reads it. Hand her an image and she sees it — actual vision, not a filename guess. Hand her a CSV and she queries it with real SQL — sums, group-bys, sorting, on your actual data.

She runs your Mac

System volume, dark mode, music, calendar and reminders — the small stuff is a one-liner now. “Volume to 30, dark mode on, and remind me at 6” just happens.

She researches on her own

Ask a real question and Mori runs deep research — she breaks it into angles, sends parallel sub-agents to search the live web and actually read the best sources, then hands back a clear answer with a Sources list. Not a snippet; a briefing.

She recalls anything you've discussed

Every past conversation is searchable. “What did we decide about the pricing page last week?” — she finds it, with the date, at zero cost to the current chat.

Real code powers, safely

Full git (status, diff, commit, branches), Python, and a proper terminal. For big or risky work she can spin up an isolated workspace — its own git branch and folder — so nothing touches your main project until you merge. And she checkpoints every file before she changes it, so a bad edit is one rollback away.

Give her your files

Attach files right in the chat — PDFs, images, spreadsheets, code — and she reads them. No copy-pasting paths.

She moves fast

Multi-step jobs run as one fast operation instead of a slow step-by-step back-and-forth — she plans the whole thing and executes it in a single pass.

Three modes

Settings adapts to you. Simple shows just the essentials; Business adds ops — schedules, socials, autonomy; Developer opens everything — all tools, systems, and the workbench. It changes what you see, never what she can do.

Connections (MCP)

Mori speaks the Model Context Protocol. Connect her to MCP servers — filesystem, GitHub, Slack, Postgres, web search, and hundreds more — and every tool those servers expose becomes one of Mori's tools, on every provider you use.

Adding a server

Open Settings → Connections (visible in Power mode) and paste a config in the same shape as Claude Desktop's — if it works there, it works here:

{
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"]
}

Remote servers connect by URL instead:

{ "url": "https://your-server.example.com/mcp" }

Business

Mori can help run a brand — starting with its socials. Ask her to push a launch and she uses draft_social_post to write posts into an approval queue in Settings → Business. You review each draft there and publish it with one click — or throw it out.

Going live

Live posting runs on your own API keys — X, Meta, LinkedIn — added in Settings → Business. Stripe, Resend, and Shopify keys slot in there too, for the payments, email, and store side of the operation.

Markets desk

A live board for crypto majors and prediction markets (Polymarket & Kalshi). Mori pulls live prices and market stats, researches what's moving, and preps an order ticket for you to review — placing it is always your tap, never hers.

The safety line

This boundary is deliberate and does not move:

• Mori never enters a password or credentials.
• Mori never auto-executes a trade or places a bet — you tap it yourself.
• Mori never generates a trade decision for you to act on blindly.
• Mori never clicks a final Pay without your explicit confirmation.
• Mori never publishes a social post without your one-click approval.
• Your keys and money stay under your control.

Mori Link — Mori on your phone

Mori Link is the official iOS app. It turns your phone into a remote for your desktop Mori: chat, build, run real tasks, take screenshots — everything the desktop app and the Discord/Telegram bots can do, in a real native interface. No messaging app required.

Pairing

Sign into Mori Link with the same Studio Mori account as your desktop. In the app's Chat, tap the desktop icon, then “Generate pairing code.” On your Mac, open Mori → Mori Link and type the 6 digits. Both devices confirm over an encrypted realtime channel — and your Mac will only ever run commands from that one confirmed phone.

What it can do

Run terminal commands, read/edit/build files, drive your real browser, send email, execute multi-step jobs, and use your full memory and tools — all on your actual machine. Screenshots land right back in the chat. It's the same agent engine as the desktop, so anything Mori can do at her desk, she does from your pocket.

Platforms

iOS is first and in private beta; the App Store release is close. Android and iPad come next.

Accounts & sync

Sign in with email or GitHub to sync your conversations, tasks, and orders. Accounts are powered by Supabase with row-level security — your data is yours.

Stay signed out and Mori still works fully; everything just lives locally instead of syncing across devices.

Building with Mori

Because Mori can see, click, type, code, and run a shell, the set of things you can ask her is open-ended. A few starting points:

Pricing

The free app is the complete product — every tool, unlimited with your own API keys. Subscriptions add managed access: Mori runs on frontier models we provision, no keys required, with usage that flows in 5-hour sessions that refill on their own. Full comparison on the pricing page; the honest fine print lives in Managed vs your own keys.

Updates

Mori updates herself. The app checks quietly on launch and every few hours, downloads the new version in the background, and shows one small pill — Update ready, restart — when it's waiting. Quitting the app also applies a downloaded update. macOS updates are signed and notarized end to end; a manual check lives in Settings → Updates, with the release notes right there. If the update feed is ever unreachable, nothing breaks — Mori just tries again later.

What's landed so far:

Support

Mori is built by a small team that's heads-down making her better every single day — new models wired in, features shipped, bugs fixed, and the model catalog kept current. You're not buying a frozen app; you're joining something that grows weekly.

Getting help

• Community — join the Discord to ask anything and see what others build.
• Email — Free & Pro get email support; Pro is prioritized.
• Dedicated team — Studio includes real humans who help you set up, and build your workflows.