OmniRoute CLI Cloud 用于在命令行中控制 OmniRoute 的云端智能体，支持 OpenAI Codex、Devin 和 Jules（Google）三种代理。使用前提是已安装 omniroute CLI，其安装方式与全局参数见 CLI 入口技能说明，本文暂未提供具体安装命令。
主要能力
- 智能体认证：为 Codex 设置或刷新 OpenAI API Key，为 Devin 设置或刷新 Devin API Key，Jules 则通过 OAuth 登录（会打开浏览器）。
- 查看代理列表：列出已配置的云端智能体及其状态，支持 JSON 输出。
- 创建任务：为指定智能体创建任务，可提供标题和提示词，提示词也可从文件读取。
- 任务查询：列出某智能体的全部任务（表格或 JSON），获取任务完整记录或仅查看状态与进度。任务状态包括 running、completed、failed、cancelled。
- 计划审批：Devin 和 Jules 在写代码前可能暂停等待计划审批，可用 approve 命令批准。
- 任务交互：向运行中的任务发送消息以调整方向，例如要求只处理后端、跳过 UI。
- 来源查看：列出任务更改或创建的文件。
- 取消任务：终止指定任务。
使用方式
先按智能体类型完成认证，例如 omniroute cloud codex auth、omniroute cloud devin auth 或 omniroute cloud jules auth。随后创建任务，例如 omniroute cloud codex task create --title "..." --prompt "..."，也可用 --prompt-file 从文件读取提示词，devin 与 jules 的语法相同。查询时可用 task list、task get、task status；审批用 task approve；追加指令用 task message；查看文件用 task sources；终止用 task cancel。JSON 输出便于配合 jq 等工具提取任务 ID 并轮询状态。
典型流程为：认证 → 创建任务并取得 ID → 轮询状态 → 完成后查看涉及文件。
适用场景
适合希望在终端或脚本中统一调度多个云端编码智能体、批量创建与跟踪任务、对需要人工确认的计划进行审批，以及把任务状态接入自动化流程的开发者。
限制与错误处理
未认证时任务命令会失败，需先执行对应 auth 命令。创建任务返回 402 表示智能体计费额度已达上限，需检查相应账户。审批返回 404 表示任务没有待审批计划，应先查看状态。Jules 浏览器授权失败时，需确认 Google 账户具有 Jules 访问权限后可重试。