Reference

Keyboard shortcuts, ui-cli commands, the settings tree, paths, ports and platform requirements.

Keyboard map

⌘KCommand palette: sessions, commands, and full-text transcript search. Also opens from Search at the top of the left column
⌘NNew window
⌘1…⌘9: jump to group N (⌘9 is the last group)
⌥1…⌥6: focus pane N in the current group
⌘⌥←Cycle pane focus (⌘⌥→ forwards)
⌘FFind in the transcript, with next, previous and a match count

mirasim ui-cli help prints the full command list. Commands that act have the same effect as doing the same thing in the app.

Read

Command	What it returns
state	Host bootstrap: version, working directory, platform
agents · clis · cli-tools	Installed agents and their default; agent CLI versions; dev CLIs on PATH and their auth
sessions · history · queue	Session rows; a session's settled turns; its queued prompts
catalog · commands · models	Composer options for an agent; its slash commands; the BYOK provider/profile/binding layer
accounts · usage · relay	Stored accounts with quota; per-agent quota snapshots; Mirasim platform sign-in, credits and routing mode
workspaces · git	Registered folders; one folder's live Git status
mcp list · connectors list · skill list	Tool inventory at each scope
traffic stats · calls · meta	Usage statistics, recent calls, and the disk space the usage records take
system · permissions · resources	Host telemetry; macOS permission states; a resource baseline

Act

Command	What it does
prompt · send · watch · stop	Start or continue a run (blocks until the turn settles), stream snapshots, interrupt
answer	Answer an agent's interactive prompt — the scriptable “click Allow”
queue steer \| jump \| recall \| move	Hand a queued prompt to the running turn, cut the line, take it back, reorder
session new \| open \| rename \| delete \| resume	Session lifecycle, including printing the native resume command
workspace add \| update \| remove	Register, edit, unregister a workspace folder
account use \| add \| rename \| token \| remove · login · logout	Agent account management; sign in to or out of your Mirasim account
provider · profile · model bind · model test	The BYOK layers, and one real round-trip to prove it
local probe \| start \| pull \| pulls \| delete	Local inference backends and models
mcp add \| remove \| toggle \| health	MCP servers at workspace or global scope
skill install \| create \| update \| remove	Skills at workspace or global scope
connectors install \| enable \| validate \| auth \| search \| uninstall	Connector lifecycle, including the official registry
codex-reset · restart	Redeem a Codex limit reset; restart the host

Config and shell

Command	What it does
config get \| set \| apply	Read the whole settings tree, set dot-paths, or converge onto a desired tree (--dry-run shows the diff)
screenshot · shell	A PNG of the real app window; window and app facts
navigate · ui · dom · click · press · type · read	Route the UI, run a semantic UI command, list actionable controls, and drive them by text or selector
raw	Post any protocol frame verbatim

config get returns one JSON tree covering every saved setting. Keys and tokens are not included.

defaultAgent: The agent new sessions start with.
agents.<agent>.{model,effort,accessMode}: Per-agent default model, reasoning level, and whether it runs on a subscription or an API key.
relay.mode: Routing: local uses your own accounts, cloud uses Mirasim platform credits. Neither falls back to the other automatically.
computerUse.guiAgentEnabled · computerUse.guiPreviewEnabled: Enable Computer Use tools and show their live preview.
computerUse.{guiEmbeddedBrowserEnabled,guiManagedBrowserEnabled,guiExtensionBrowserEnabled}: Independent switches for the embedded browser, independent browser and browser extension. They can be enabled together.
computerUse.{guiBrowserBinary,guiBrowserDir}: The independent browser's executable and data folder.
computerUse.{macosControlEnabled,macosAllowedApps}: Allow native macOS control and list apps that may be used without asking. Other apps ask for permission when first used.
preventDisplaySleep · agentAutoUpdate: Keep the screen awake while the app runs; keep agent CLIs up to date.
workdir · workspaces[]: The default working directory and the registered workspace folders.

On disk

Path	Holds
~/.mirasim/setting.json	Host settings — what the Settings UI and `config set` write
~/.mirasim/traffic	Per-call usage records (no message content)
~/.mirasim/capture.off	Create this file to disable recording from the next launch
<workspace>/.mirasim/schedules.json	This workspace's scheduled prompts
<workspace>/.mirasim/	Workspace-scoped skills and configuration that belong in your repo

Ports ui-cli connects to

Port	Instance
4970	The installed desktop app's server
4939	A server started by `mirasim serve` — its default port
(none)	Spawn a private throwaway server for one command

Platform requirements

Surface	Requires
Desktop	Apple Silicon or Intel Mac, macOS 13 Ventura or later; Windows 10 1809 or later (x64, Arm64); or Linux via AppImage / .deb (x86_64, arm64)
Android	Android 8.0 or later
iPhone	iOS 15 or later, TestFlight beta
CLI / TUI	Comes with the desktop app; on a Linux server without a desktop, x86_64 through the one-line install (chapter 12)

Useful environment variables

MIRASIM_RECORD=0            # turn off usage recording for this launch
MIRASIM_ANALYTICS=0         # send no usage statistics for this launch

Something wrong or missing on this page? Tell us