CLI, TUI and ui-cli

The mirasim command

The mirasim command launches Claude Code and Codex, manages accounts and routing, runs the server, and runs diagnostics. It comes with the desktop app: once Mirasim has started on a computer, it is at ~/.mirasim/bin/mirasim. mirasim claude and mirasim codex open each agent's own terminal UI.

~/.mirasim/bin/mirasim doctor                        # check the install and its environment
~/.mirasim/bin/mirasim claude                        # Claude Code
~/.mirasim/bin/mirasim codex                         # Codex
~/.mirasim/bin/mirasim agents                        # installed versions and updates
~/.mirasim/bin/mirasim ssh ubuntu@dev.example.com    # connect to a server over SSH
~/.mirasim/bin/mirasim ui-cli help                   # the whole control surface

The other commands are below. mirasim help prints the full list.

The current route shows in Claude's status line and in Codex's terminal title. Your own status line is kept, and you or other tools can add a segment to it.

mirasim statusline set deploy "staging ✓"

ui-cli: the app, scriptable

ui-cli drives a running Mirasim from the command line. What you can do in the app is available as a command, and the effect shows up live in the open window. Each call prints one JSON object, for use from scripts and agents.

# read-only facts, safe any time
mirasim ui-cli --port 4970 state
mirasim ui-cli --port 4970 sessions --limit 20
mirasim ui-cli --port 4970 workspaces

# start a real run — identical to typing it in the UI
mirasim ui-cli --port 4970 prompt --agent claude \
  --cwd ~/code/proj --text "summarize this repository"

# drive and observe the actual window
mirasim ui-cli --port 4970 navigate --to settings
mirasim ui-cli --port 4970 ui settings.open --value traffic
mirasim ui-cli --port 4970 dom
mirasim ui-cli --port 4970 click --text "By model"
mirasim ui-cli --port 4970 screenshot --out shot.png

Settings as one declarative tree

Every saved setting forms a single JSON tree: the default agent, per-agent model, effort and access mode, the routing mode (your own accounts or platform credits), browser and screen automation toggles, display sleep, agent auto-update, the working directory and registered workspaces. You can read the whole tree, set individual dot-paths, or apply a desired tree in one go.

mirasim ui-cli --port 4970 config get

mirasim ui-cli --port 4970 config set \
  defaultAgent=codex relay.mode=cloud

# see exactly what would change, then apply only that
mirasim ui-cli --port 4970 config apply --file desired.json --dry-run
mirasim ui-cli --port 4970 config apply --file desired.json

config apply changes only the fields that differ from the live values, takes effect immediately, and is safe to run again. The reply lists each changed field with its before and after. The platform key, account tokens and provider keys are not in the tree; set them with their own commands.

When a command does not exist yet

raw sends a protocol frame as-is and prints the responses. Use it for an operation that has no command of its own yet.

mirasim ui-cli --port 4970 raw '{"type":"…"}' --await someReplyType --seconds 5