命令行、终端界面与 ui-cli

在终端运行智能体，用脚本驱动应用，并以一棵 JSON 树读取和应用全部设置。

mirasim 命令

mirasim 命令可以启动 Claude Code 与 Codex、管理账号与路由、运行服务端和自检。它随桌面应用提供：Mirasim 在一台电脑上启动过之后，它就在 ~/.mirasim/bin/mirasim。mirasim claude 与 mirasim codex 打开各自智能体原本的终端界面。

常用命令

~/.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

其余命令如下，完整清单以 mirasim help 为准。

命令全集

命令	作用
login [github\|email]	登录，可选第三方授权或邮箱验证码，会保存令牌。
logout	清除已保存的登录令牌。
agents	已安装哪些智能体、各自版本，以及是否有新版本。
update [agent]	按各自安装时使用的渠道更新智能体。
accounts [add\|use\|remove]	列出订阅账号，并切换智能体以哪个账号启动。
relay [mode\|key]	查看当前路由和平台连通状态。mode local\|cloud 在自有账号和平台额度之间切换；key 手动填入平台密钥。
statusline [set]	查看正在运行的智能体的实时路由；set 把你自己的文字加进那一行。
doctor	自检安装、配置与记录功能。
serve	运行服务端：网页工作台与配对。默认端口 4939；--host 127.0.0.1 只监听本机回环地址。
ui-cli <cmd> [flags]	通过服务端协议驱动界面，供智能体与脚本使用。--port N 连到已在运行的 serve，否则自行拉起一个。
chat <cmd>	在终端里读写这个空间的聊天，不需要打开应用。
publish <verb>	把这个空间里做好的东西对外发布：init、check、preview、submit、status 等，需要应用在运行。
ssh <user@host> [list\|stop\|uninstall]	通过 SSH 连接 Linux 或 macOS 服务器，并管理已保存的服务器。
checks [session]	对某次已记录的会话执行确定性检查。
eval	查看本机的 eval 技能仿真记录：运行列表，以及带截图的逐用例轨迹。默认端口 4960。
version · help	版本号，以及权威命令清单。

当前路由显示在 Claude 的状态行和 Codex 的终端标题里。你原有的状态行会保留，你或其他工具也可以往里加一段。

添加自己的状态段

mirasim statusline set deploy "staging ✓"

ui-cli：应用的可脚本版本

ui-cli 用命令行驱动正在运行的 Mirasim。界面上能做的操作都有对应命令，效果会实时出现在已打开的窗口里。每次调用输出一个 JSON 对象，供脚本和智能体使用。

选择实例

参数	对应实例
--port 4970	已安装桌面应用的服务，通常选择这一项。
（不提供 --port）	为这一条命令启动的用后即弃的私有服务。
--shell desktop \| mobile	由哪个客户端响应外壳类操作：桌面窗口，或已配对的手机。

读取状态、执行任务、驱动窗口

# 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

把设置视为一棵声明式配置树

所有保存的设置构成一棵 JSON 树，包括默认智能体、各智能体的模型、推理强度与访问方式、路由方式（自有账号或平台额度）、浏览器与屏幕自动化开关、屏幕休眠、智能体自动更新、工作目录和已登记的工作区。你可以整棵读取、按点分路径单独设置，也可以一次应用一整棵指定的配置树。

读取、设置与应用

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 只改与当前值不同的字段，立即生效，可以重复执行。返回结果列出每个改动字段的前后值。平台密钥、账号令牌和供应商密钥不在这棵树里，要用各自的命令设置。

命令尚未覆盖某项能力时

raw 原样发送一条协议帧并输出返回结果，用于还没有对应命令的操作。

原样发送协议帧

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

这一页有错或缺了什么？告诉我们