介绍
rayrun 是 Rayrun 的命令行工具，把创建、进入、管理沙箱的常用操作收在一处。
它是 REST API 的薄封装 —— 命令行能做的事，API 都能做。
命令按主题分成八组，点进任意一组看参数与示例：
| 主题 | 涵盖的命令 |
|---|---|
| 安装与配置 | login、logout、upgrade、version —— 装 CLI、登录账号、在线升级、自检版本 |
| 沙箱生命周期 | run、sandbox —— 创建 / 查看 / 销毁 / 停止 / 启动 / 暂停 / 恢复沙箱 |
| 命令执行 | exec —— 在沙箱内跑命令，或开交互终端 |
| 文件 | files —— ls / get / put |
| Agent 交互 | prompts、events —— 投递 prompt、订阅事件流 |
| 凭证 | credentials —— 设置 / 列出 / 删除（值永不回显） |
| 审计与用量 | audit、usage —— 审计查询与哈希链校验、用量统计 |
| 命令 | 描述 |
|---|---|
rayrun login |
账号密码登录，自动创建命令行专用 Token 并保存本地 |
rayrun logout |
吊销命令行 Token 并清除本地凭据 |
rayrun upgrade |
显式检查并安装 CLI 自身更新（--check / --yes / --force） |
rayrun run |
创建并启动沙箱 |
rayrun exec |
在沙箱内执行命令，或开交互终端 |
rayrun sandbox |
查看、销毁、停止/启动/暂停/恢复沙箱 |
rayrun prompts |
向 agent 投递 prompt，或中止当前任务 |
rayrun files |
在本地与沙箱之间列目录、上传、下载 |
rayrun events |
订阅沙箱事件流（断线自动续传） |
rayrun credentials |
设置、列出、删除凭证（值永不回显） |
rayrun audit |
查询审计事件、校验哈希链 |
rayrun usage |
查看计费用量（VM 小时 / 出向字节 / tokens） |
rayrun version |
打印 CLI 自身版本与构建目标 |
全局参数：--api-url / --token / --json —— 任何命令都认
（见安装与配置）。