Quickstart

Install Mirasim

1. Download it for your computer

   The Download page picks the right build for you. macOS needs 13 Ventura or later, with separate builds for Apple silicon and Intel. Windows needs Windows 10 1809 or later. Linux ships as an AppImage or a .deb for Ubuntu 22.04 or a distribution of the same age.

2. Open it

   On a Mac, drag Mirasim into Applications and open it; if macOS asks about an app from the internet, choose Open. On Windows, if SmartScreen shows a prompt the first time, confirm it to go on.

The phone app is on Android, and on iPhone through TestFlight (chapter 20). The list of files in each release and how to check them is in chapter 23.

Sign in

Mirasim asks you to sign in first, and there is no skip. Continue with Apple, GitHub, Google, X or a passkey, or type your email and finish in the browser with the code we send you. Tick the box to agree to the Terms and the Privacy Policy before you continue. The next step opens by itself once you are in.

If this account is already in a cloud space — you were invited, or bought one — a screen lists Your spaces: press Enter to go there, or pick This computer, the last row, to work here. Without a cloud space this screen never shows and you go straight to this computer. An invite link from a teammate is opened, not pasted: click it and the app takes you in.

Get one agent running

On the first launch, if this computer cannot run a turn yet — no usable agent, or a credit source that cannot pay for it — Get started opens as a dialog over the window. Its only ways out are Later and Start a session. A computer that can already run one — Claude Code or Codex signed in, or OpenCode installed — skips the dialog: Get started just says Ready, with Start a session.

Later closes the dialog. Come back any time from Get started in your avatar menu at the bottom left. If a message cannot be sent, the line above the composer says why and takes you back here.

Send your first message

Start a session opens a new session in the middle of the window and Mira Bot's chat on the right. You can send your first message either way:

1. Run it yourself

   Write the result you want in the box in the middle and send it. Under the box you pick the agent, model and reasoning level; under that, the folder the session runs in.

2. Hand it to Mira Bot

   Tell Mira Bot on the right what you need. It hands the work to a suitable assistant, one session per job, and comes back to tell you when it is done.

Mira Bot opens with three small things: connect Git and GitHub; pick what you mostly do, and it sets up two or three assistants for it; and one thing you want done now, which two agents can each do a version of, side by side. Pressing these only fills in the message box — nothing runs and no credit is spent until you send. Under them are Meet the assistants, and Use this computer from your phone, which makes this computer a collab space for free (chapter 13).

While a turn runs you can queue the next message, steer it, or stop it (chapter 06). Changes are written into the folder itself: press the folder name under the message box (or ⇧⌘E) to open its files and Git changes beside the session, or go to the Workspaces page on the left to commit (chapter 10).

• ⌘KSearch the list on the left
• ⌘BFold or bring back the list on the left
• ⌘,Settings
• ⌘/The shortcuts for the page you are on

Updates, changelog and feedback

Other ways to use Mirasim

Claude Code and Codex on your phone →

Multiplayer coding agents with friends and teammates →