The Guide

What is Mori

Mori is a desktop agent that does the work. She lives on your Mac or Windows machine, not in a browser tab. She builds in any language, makes games and mods, drives your creative apps through their own scripting, makes pictures, clips, sound and 3D worlds in Creation, works in your real signed-in Chrome, and uses your screen when a job needs it. She carries 299 native tools, and can hand work to helpers that hand work further, three levels deep.

You give her a goal in plain language, and you can keep talking to her while she works. She does not stop to ask you to click Allow: only your system asks, for its own permissions, and her own rails refuse what should never run.

Install

Mori runs on macOS 13 and later, and on Windows 10 and 11. The Mac app is signed and notarized by Apple, so it opens with a normal double-click. The Windows installer is signed by Vyridian L.L.C. and may still get one SmartScreen prompt on first run; choose More info, then Run anyway.

macOS    Download the DMG, open it, drag Mori to ApplicationsWindows  Download the installer and run it

On first launch Mori asks you to accept her terms, puts Node, Python and Git in her own folder (with uv, rg and jq beside them), then offers a sign-in: email, GitHub, Google, or continue without an account. The downloads are checked against their checksums, need no admin password, and change nothing outside her folder.

Terminal install

Prefer the command line? One line gets you the same app.

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

On the Mac, your system asks for its own permissions, and those are the only prompts you see. Settings, System Access lists them:

• Screen Recording: lets Mori see the screen when a job needs it.
• Accessibility: lets her press buttons and type in your apps.
• Microphone: for talking to her.
• Camera: optional.

macOS also asks once per app when Mori scripts it (Automation). To work in your signed-in Chrome on the Mac without the extension, enable Allow JavaScript from Apple Events under Chrome's View, Developer menu. On Windows no extra system permissions are needed; only Windows' own admin prompts appear.

The Setup page

Setup shows what Mori has to work with: your system permissions, a provider key, the command line tools, a deploy account, Mori Chrome and Mori Link, with an explainer on how she works. The app opens Setup once, then always opens on Home. A key's live test is on the Providers page.

Quick start

Once she is open:

1. Sign in to use a plan's credits, or open Providers and paste a key. One is enough.
2. On Home, ask for something real. Try a small build or a picture.
3. Keep typing while she works: a note, a question, or a change of plan.
4. Watch the boxes and the side panel: the plan, the activity, the preview.
5. Open Creation to see what she made, ready to change.

How API keys work

Bring a key from a provider you already use, and Mori runs chat, the agent loop, tools, coding and computer use through it. You pay your provider for what you use. Or sign in and use a plan's credits, with no key at all.

Keys live in Mori's settings on your machine. Keep keys for several providers and set one active. Creation's own keys, for Runway, Google, OpenAI, Black Forest Labs, fal, Replicate, Luma, Stability and ElevenLabs, go in Providers, Media.

Providers

Nine cloud providers are built in, plus local models through Ollama, plus Managed by Studio Mori when you are signed in. Each provider is one row on the Providers page that opens to its fields, with a live test.

Models

The model is Auto unless you pick one: the depth decides. Instant runs Haiku 4.5, Quick runs Sonnet 5.5, and Balanced, Deep and Max run Opus 5.5, thinking harder at each notch. Pick a model by hand and it stays; the depth then sets how hard it thinks. See Mode and depth.

Local models (Ollama)

Run models entirely on your own machine. No key, no cloud. Mori talks to Ollama at localhost:11434 and lists the models you have pulled. Pull one first:

ollama pull llama3.2

The full catalog of models you can pull lives at ollama.com/library.

Computer use

Mori reads the buttons, fields and menus of your real apps and presses them by name. She looks at the screen only when the job truly needs it, and while she uses your computer a slim bar at the top of the screen says what she is doing, with a Stop button. Banking and trading apps can be looked at, never pressed. The deep dive is Computer use and the browser.

Browser

With the Mori Chrome extension, web work runs in your own Chrome, signed in as you. Settings, Chrome picks where it runs: Let Mori pick, Mori's Chrome, or My browser. Without the extension, a built-in browser reads the page and clicks by selector.

Shopping

Mori compares real listings, adds the right item to your cart, and fills in shipping up to the final order screen.

Coding and preview

Mori writes whole projects into real folders, in any language, with real toolchains she sets up in her own folder: C, C++, Lua, Rust, Go, Python, Java and more, emulators included. She builds, reads the errors and fixes until it passes. Pages open in the Mori Preview window, where she clicks through them herself.

Point her at a site, a repository, a video or a picture and she reads all of it before she builds from it. The full system is in Coding and builds, and games in Games and mods.

Terminal

A real shell, built in. Mori runs npm, git, build tools and dev servers with live output. Named sessions stay alive across turns, and you can type into the same shell she is driving, in the side panel's Terminal tab. The commands that can wreck a computer are refused. See Terminal sessions.

Voice and vision

Talk to Mori out loud with your own ElevenLabs key. Spoken replies are off until you turn them on, and need that key or a paid plan. She also sees: screenshots when a job needs them, and any picture you hand her.

The window

The sidebar keeps your threads and projects, with Home, Creation, Community, Profile and Settings pinned under them and every other page one click away in More. Cmd+K searches everything: pages, settings, threads (and the words inside them), projects, skills, tools and commands.

While Mori works, each step is a row you can open, each piece of work and each helper is a box with a title from the actual work, and a time estimate shows how long is left. When she uses your computer, a slim bar at the top of the screen says what she is doing, with her logo and a Stop button.

The brain

The agent behind the face keeps getting sharper. In practice:

She remembers you

Memory is plain files you can read. Who you are, how you like things done, what you are working on. Everything she remembers is visible and removable. See Memory.

She learns from her own work

Builds that go well become skills, waiting for your yes. On a paid plan, finished tasks become playbooks, failures become lessons, and her memory grows into a brain with dates.

She researches on her own

Ask a real question and Mori runs deep research: the sources she read, the ones she did not, and the trail that produced the answer.

She reads your files for real

Hand her a PDF and she reads it. Hand her a picture and she sees it. Hand her a CSV and she queries it.

Every change can be undone

Full git, Python and a proper terminal. Each thread can work in its own worktree, and every file is checkpointed before she changes it, so a bad edit is one rollback away.

Connections (MCP)

Mori speaks the Model Context Protocol. On the MCP page, paste a server's link and press Connect, or pick one from the directory. Mori checks it, opens its sign-in in your browser when it asks for one, and its tools become hers, on every provider you use.

The details, including Mori as a server for other agents, are in MCP.

Business

Mori can help run a brand. Ask her to push a launch and she drafts posts into a queue in Settings, Business. You publish each draft or throw it out. For paid ads, see Ads: drafts are created paused, and nothing spends without your yes.

The lines that hold

Mori works without approval cards, and these lines hold whatever you switch:

• Text in a page, a file or a message never makes her act on its own.
• She never types a password or card details.
• In your Chrome and on your screen she never presses a final pay button.
• Banking and trading apps can be looked at, never pressed.
• An ad goes live or gets a budget only on your yes.
• Your keys are never sent anywhere you did not choose.

Her own rails, and the switch that turns them off at your own risk, are in Asking and the safety rails and Security.

Mori Link, Mori on your phone

Mori Link is the official iOS app, free on the App Store. It turns your phone into a remote for your desktop Mori: chat, build, run real tasks, and check results from anywhere. Same Mori, same memory.

Pairing

Sign in with the same Studio Mori account as your desktop. In Mori Link, open Chat, tap the desktop icon, and generate a 6-digit pairing code. Type it into the Mori Link page of the desktop app, on Mac or Windows. Your computer only ever runs commands from that one confirmed phone.

What it can do

Run terminal commands, read and build files, drive your browser, and run multi-step jobs on your actual machine. Screenshots land right back in the chat.

Accounts and sync

Sign in with email, GitHub or Google for your plan, your dashboard and Community. On a paid plan, threads and memories sync across your devices. On Free, or signed out, everything lives on your machine.

Building with Mori

Because Mori can build, see, click, type and drive your creative apps, the set of things you can ask is open-ended. A few starting points:

• Build me a landing page like this site, and preview it.
• Make a Roblox obby with a leaderboard.
• Turn these clips into a 15 second commercial.
• Build a showroom where I can move everything.
• Write a CHIP-8 emulator in C and prove it with the test ROMs.
• Deploy the site to my Vercel and send me the link.

Pricing

The app is free on your own API keys, with unlimited model use. Every paid plan is the same Mori, with the same models and skills; a higher plan adds credits, spent at cost on any model, pictures, clips and cloud machines, and more room. The full comparison lives on the pricing page, and the fine print in Plans, credits and your own keys.

At a limit Mori says what is left and when it resets: sessions refill within five hours, the month's credits on the 1st, and your own keys keep going meanwhile. The app never locks. Cancel anytime.

Updates

Mori updates herself. She checks shortly after launch and every few hours, downloads in the background, and shows Update ready, Restart in the sidebar. Quitting also installs a downloaded update. Check for updates is in Settings, Appearance.

Support

Getting help

• Email: support@studiomori.ai.
• The support page answers the common questions.
• Ask Mori herself: Cmd+K answers how do I questions inside the app.