Documentation

What is Mori

Mori is a desktop AI companion that actually does things. She lives on your Mac as an animated Live2D character, and behind that face is an agent that can see your screen, drive your mouse and keyboard, browse the web in your real signed-in Chrome, write and run code, prep trades, and talk 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 as a macOS app (Apple Silicon, macOS 13+). Download the .dmg, open it, and drag Mori to Applications.

First open

Because the beta isn't notarized yet, the first launch needs a right-click:

1. Download StudioMori.dmg
2. Open it, drag Mori → Applications
3. Right-click Mori → Open  (first time only)
4. Click "Open" on the dialog

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

Nine providers are built in. Add a key for any of them in the Providers page, set one active, and test the connection.

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.

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.

Trading cockpit

A live board for crypto (Solana + majors) and prediction markets (Polymarket & Kalshi). Link a Phantom wallet address to see positions. Mori pulls live prices and the market stats, and preps an order ticket for you to review.

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.
• Your keys and money stay under your control.

The Mori model

Mori herself is a Cubism 4 Live2D model — she tracks your cursor, blinks, breathes, lip-syncs to her voice, and has a full set of expressions. In companion mode she floats on your desktop, click-through, watching where you point.

Upload any Live2D model

Mori doesn't have to be Mori. Drop in any Live2D / Cubism model and she comes to life with that body — a character you bought, commissioned, rigged yourself, or pulled from a VTuber kit. If it's a valid Cubism model, Mori can wear it.

What you need

A standard Cubism 4 export — the model folder with its core files:

your-model/
  model.model3.json   ← point Mori at this
  model.moc3
  textures/ *.png
  model.physics3.json   (optional)
  *.exp3.json           (expressions, optional)
  *.motion3.json        (motions, optional)

How to add it

1. 1Open the Models page in Mori.
2. 2Choose Import model and select the .model3.json.
3. 3Nudge scale / offset so she sits right in the window.
4. 4Save — she's now your character, everywhere Mori appears.

Expressions and motions defined in the model are detected automatically, and lip-sync drives the standard ParamMouthOpenY parameter — so your model talks when Mori talks.

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, GitHub, or your Phantom wallet 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 app and every core feature are free — you bring your own keys, so AI usage is billed by your provider, not us. Paid tiers add cloud sync, a curated model catalog, and human support that helps you build.

Updates

Mori ships constantly. Here's what's landed and what's next.

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, rig custom Live2D models, and build your workflows.