ROCK CLI 是用于操作沙箱的命令行工具，命令名为 rockcli，也可用别名 rc。
用途与主要能力：管理沙箱生命周期（启动、停止、查看状态），在沙箱内执行命令，上传与下载文件，查看和搜索日志，查看历史操作记录，回放请求，以及通过 attach 进入交互式会话。
安装与更新：安装命令为 bash -c "$(curl -fsSL http://xrl.alibaba-inc.com/install.sh)"；升级推荐使用 rockcli update。小版本自动升级，major/minor 需手动升级。
认证配置：三种方式，环境变量 export ROCK_API_KEY=your-api-key（优先级最高）、全局参数 rockcli --api-key your-key <command>、配置文件 ~/.rock/setting.json。
常用用法：启动并等待就绪用 rockcli sandbox start --wait-for-alive，可加 --memory 16g --cpus 4；执行命令用 rockcli sandbox <id> exec '...'；上传用 rockcli sandbox <id> upload --dir ./my-project --target-path /app --recursive，包含隐藏文件加 -a（注意 -r 短参数无效，必须用 --recursive）；下载用 rockcli sandbox <id> download --file /app/output.csv；停止用 rockcli sandbox <id> stop。交互式开发用 rockcli sandbox <id> attach，沙箱需处于 alive 状态，/exit 断开但保留沙箱和会话，/close 永久关闭会话。日志排查用 rockcli sandbox <id> log search -k "error"，指定日志文件必须用 --log-file，支持 -C 上下文、-m 时间范围、-f 字段过滤，实时追踪用 log tail。历史记录用 rockcli sandbox <id> history，回放用 rockcli sandbox <id> replay。状态用 rockcli sandbox <id> status，流转为 pending → alive → stopping → stopped。
全局选项：--verbose/-v 控制日志级别，--base-url 指定服务端地址（默认 http://xrl.alibaba-inc.com），--api-key、--cluster、-H/--extra-header 设置额外请求头。
限制：详细参数需参考 references/sandbox.md；部分参数形式有特定要求，如上传递归必须用 --recursive、日志文件必须用 --log-file。