用途：Oz 用于通过 Warp 的 REST API 和命令行运行、配置、检查云端智能体（cloud agents），适合自动化任务、定时执行和 CI 集成。
主要能力：可启动云端智能体、查询运行状态、按计划重复运行、创建和管理运行环境、为智能体提供密钥。CLI 命令包括 oz agent run-cloud（启动）、oz run list / oz run get <run-id>（列出与查看运行详情）、oz environment list / oz environment get（环境管理）、oz schedule list / oz schedule get（计划任务）。多数子命令支持 --output-format json，便于用 jq 解析。
使用方式：CLI 安装为 oz，可用 oz help 或 oz help <subcommand> 获取帮助。REST API 需 API 密钥认证，密钥在 Warp 设置的 Platform 页面生成。提供 TypeScript/JavaScript 与 Python SDK，均支持同步和异步。还可通过 GitHub Actions 使用 warpdotdev/warp-agent-action@v1 触发智能体，需提供 prompt、warp_api_key，可选 profile，输出 agent_output。
环境与限制：所有云端智能体在环境中运行，环境定义预装程序（基于 Docker 镜像）、需检出的 Git 仓库和安装命令。建议始终在环境中运行，否则可能缺少代码或工具。云端环境不存储密钥值，应使用 oz secret 命令。环境支持第三方编码 CLI（如 Claude Code、Codex、Gemini CLI 等），需使用带 -agents 标签的镜像。
适用场景：自动化 issue 分类、PR 检查、定时任务、代码仓库操作等。具体收费、价格、平台限制等资料暂未提供。