用途：minitest CLI 用于自动化测试移动端（手机/平板）与 Web 应用。原生应用运行在虚拟设备（模拟器与仿真器）上，Web 应用运行在应用配置的浏览器目标上；AI 智能体分析应用屏幕并验证你定义的验收标准。所有操作通过 CLI 完成：场景、原生构建、Web 通道、运行、批次与结果。
主要能力：管理应用与场景（scenario），创建带验收标准（--criteria）的测试场景，声明依赖（--depends-on），查看场景依赖 DAG（apps dependencies，可输出 Mermaid 流程图或 JSON），模拟依赖变更（--simulate --add/--remove）。支持测试套件设计工作流（reference/test-suite-design.md）、维护现有测试（minitest maintenance，本地代码不外传，仅发送测试流程编辑与本地 HEAD SHA）、测试文件绑定与上传、住宅代理与私有网络设置、API 密钥轮换与 CI 使用。
使用方式：安装 uv tool install minitest-cli；认证 minitest auth login，检查 minitest --json auth status；设置目标应用 export MINITEST_APP_ID=<uuid> 或 --app <uuid>。命令形状为 minitest [--json] [--app <APP_ID>] <subcommand> [args…]。智能体必须始终传 --json（输出 camelCase JSON 到 stdout，诊断到 stderr）。例外：app-knowledge 与 auth api-key 的 --app/--json 需放在子命令之后。升级用 minitest upgrade。
适用场景：移动与 Web 应用的端到端验收测试、从代码库设计完整测试套件、UI/代码变更后维护测试、CI 中通过 MINITEST_API_KEY 运行。
限制：Web 应用需在 Minitest Web 应用中配置执行目标后才能运行；无 apps delete；连接器无法从 CLI 创建；住宅代理与私有网络仅工作区所有者/管理员可改；维护命令的 JSON 字段契约需通过 minitest maintenance --agent 获取，部分租户该端点返回 500；退出码 0 成功、1 一般错误、2 认证、3 网络、4 未找到、5 构建无效、6 冲突。