The Mirasim Guide
Everything about using Mirasim, in one place — install and first run, several agents at once, the code tools beside them, your own models and costs, skills and tools, whole goals handed over, simulated-user evaluation, and every surface it runs on.
One screen, most of the guide
The real workbench, captured from the running app. Step through it to see what each part of the window is, and which chapter covers it.
The windowSessions and workspaces down the left, the pane stage in the middle, the prompt box along the bottom, and the code surfaces on the right.Core concepts — this control is not on the captured screen.
The buttons in this panel work — click them to look around.
Start where you actually are
Your first hour
Install it, learn the five words the product is built on, and finish one real task you actually reviewed.
Go parallel without losing the thread
Several agents at once: queues and steering, branches and worktrees, panes and groups, then the code tools beside them.
Make it yours
Your models and accounts, your cost ledger, your skills and tools — then hand off whole goals and evaluate the result.
Get started
Install it, run one real task, and learn the handful of ideas the rest depends on.
Build
The workbench itself — parallel sessions, queues, branches, panes, files, Git and terminals.
- 03Parallel sessions10 min
Several agents talking at once, and a way to switch between them that does not lose your place.
- 04Queues and steering8 min
Queue what comes next, steer what is running, cut the line, or take it back — per session, without stopping the work.
- 05Branches, reruns and worktrees9 min
Take one conversation two directions, run a turn again, and let parallel agents edit the same repo safely.
- 06Panes, groups and windows9 min
Split the stage, keep several scenes on tap, put documents and terminals beside your agents, and drive it all from the keyboard.
- 07Files, Git and terminals12 min
The code side of the workbench: browse and edit the real repo, jump through it, review and commit, search everything, preview what came out.
Models & cost
Which model runs a session, whose account pays for it, and what it actually cost.
- 08Models, accounts and quota11 min
Swap the model and reasoning level per session, bring your own keys or run local, juggle several accounts, and fall back when quota runs dry.
- 09Usage and cost7 min
Every model call in one local ledger — tokens, cache hits, estimated cost — computed on your machine and nowhere else.
Extend & orchestrate
Teach agents your way of working, wire in your tools, and hand off whole goals.
- 10Skills, MCP and tools10 min
Package your own way of working as a skill, connect the tools your stack already uses, and let agents drive a browser.
- 11Schedules, goals and mission control11 min
Work that runs on a clock, work you hand over whole, and one screen that tells you which of it needs you.
- 12Evaluating with $eval9 min
Send simulated users through the real thing, keep their traces as evidence, and let that decide the next task.
Everywhere
The same workspace from your phone, your chat app, your editor and your terminal.
Reference
Keyboard map, command catalog, config tree, data boundaries, and fixes for real problems.
- 15Data, recording and privacy8 min
Local-first is not network-free. Exactly what is stored, what can leave, and the two switches that stop it.
- 16Reference8 min
The keyboard map, the whole ui-cli catalog, the config tree, ports, paths and platform requirements — in one place to look things up.
- 17Troubleshooting & FAQ7 min
The problems people actually hit, and straight answers to the questions everyone asks first.
Or find it by what you want to do
Documentation organized like a product menu makes you already know the answer to look it up. This is indexed by intention instead.
- Install it and finish one taskQuickstart
- Run several agents on one repositoryBranches & worktrees
- Line up work while an agent is busyQueues & steering
- Nudge a running agent without stopping itQueues & steering
- Try two approaches to the same problemBranches & worktrees
- Keep several efforts on screen at oncePanes & groups
- Review a diff and commit itFiles, Git & terminals
- Find the conversation where we decided somethingFiles, Git & terminals
- Change the model just for this sessionModels & quota
- Use my own API key, or a local modelModels & quota
- Stop running out of quota mid-taskModels & quota
- See what this month cost, and on whatUsage & cost
- Teach agents how my project worksSkills, MCP & tools
- Connect an external tool or serviceSkills, MCP & tools
- Let an agent drive a browserSkills, MCP & tools
- Run something every weekday morningSchedules & goals
- Hand over a whole goal, not a taskSchedules & goals
- Know which of ten tasks needs meSchedules & goals
- Test whether real users could use thisEvaluating with $eval
- Check in from my phone or a chat appPhone, chat & editor
- Script or automate the appCLI, TUI & ui-cli
- Stop it recording my model trafficData & privacy
- Look up a keyboard shortcutReference
- Fix something that is brokenTroubleshooting & FAQ
Five minutes to your first build.
Start the QuickstartThis guide documents what the shipping product does today, and the product screens in it are the real interface rather than drawings of it. If something here does not match your copy of Mirasim, that is a bug in the guide — tell us at mirofish@shanda.com and it gets fixed.