Reference

The keyboard map, the whole ui-cli catalog, the config tree, ports, paths and platform requirements — in one place to look things up.

Keyboard map

Navigating

⌘KCommand palette — sessions, commands, and full-text transcript search
⌘NNew session pane
⌘1…⌘9 — open the Nth session as a pane, ordered by what needs you
⌥1…⌥6 — focus pane N in the current group
⌘⌥←Cycle pane focus (⌘⌥→ forwards)
⌥1…⌥6 — focus the Nth pane on the stage
⌘FFind in the transcript — with next, previous and a match count

Arranging

⌘DNew pane, splitting right
⇧⌘DNew pane, splitting down
⌘WClose the focused document, then its tile, then the pane
⇧⌘⏎Zoom the focused pane, and back
⌘TNew group
⇧⌘TNew tab inside the focused pane
⌃⇥Cycle groups (⌃⇧⇥ backwards)
⌥⌘→Cycle groups, the other chord (⌥⌘← backwards)

Code and terminals

⇧⌘EThe files and Git surface for this pane's workspace
⌃`Flip the focused pane between chat and the agent's terminal UI
⌃⇧`New standalone terminal pane
⌘clickGo to definition in the editor

ui-cli command catalog

`mirasim ui-cli help` prints the authoritative catalog; this is the shape of it. Read-only commands are safe to run at any time; the acting ones have the same effect as clicking in the UI.

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; relay sign-in and fallback state
workspaces · workspace git	Registered folders; one folder's live Git status
mcp list · connectors list · skill list	Tool inventory at each scope
traffic stats · calls · meta	The local usage ledger, and its footprint plus export disclosure
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	Multi-account management; login / logout for the relay
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
im validate · codex-reset · restart	Check a channel's credentials; 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 — total coverage escape hatch

The settings tree

`config get` returns one JSON tree covering every persisted setting. Secrets are deliberately not in it.

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.{enabled,threshold,on5h,on7d,reactive,always}: Quota-fallback behavior: whether it is on, at what usage fraction, per window, on refusal, or unconditionally.
computerUse.{browserEnabled,browserHeadless,peekabooEnabled}: Browser and screen automation toggles.
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.
im.<channel credentials>: IM channel configuration, applied hot.

Paths, ports and requirements

On disk

Path	Holds
~/.mirasim/setting.json	Host settings — what the Settings UI and `config set` write
~/.mirasim/recordings	Raw model request/response recordings, subject to retention
~/.mirasim/capture.off	Create this file to disable recording from the next launch
~/.mirasim/tui/	Live agent status Mirasim publishes into each agent's own status surface
<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
4950	A development desktop instance'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 Mac, macOS 13 Ventura or later — or Linux via AppImage / .deb (x86_64, arm64)
Android	Android 8.0 or later
iPhone	iOS 15 or later, TestFlight beta
CLI / TUI	macOS on Apple Silicon (darwin-arm64 archive)

Useful environment variables

MIRASIM_RECORD=0            # disable raw recording for this launch
MIRASIM_ANALYTICS=0         # collect and emit nothing at all — no product analytics
PI_GUI_CDP_URL=…            # attach browser automation to an external Chrome

Something wrong or missing on this page? Tell us