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.
| 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 |
| 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 |
| 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#
| 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 |
| 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 |
| Surface | Requires |
|---|---|
| Desktop | Apple Silicon Mac, macOS 13 Ventura or later |
| Android | Android 8.0 or later |
| iPhone | iOS 15 or later, TestFlight beta |
| VS Code | VS Code 1.90 or later |
| CLI / TUI | macOS on Apple Silicon (darwin-arm64 archive) |
MIRASIM_RECORD=0 # disable raw recording for this launch
MIRASIM_EXPORT=0 # disable the background export sweep
MIRASIM_BROWSER_CDP_URL=… # attach browser automation to an external ChromeSomething wrong or missing on this page? Tell us