用途:cursor-cloud 是 Cursor SDK 的云端运行时。在 Agent.create 时传入 cloud(而非 local),即可让每个智能体运行在专属 VM 上,任务跨网络中断持久保留,并能直接打开 PR。
主要能力:支持长时间运行任务(CI 机器人、定时重构、看板驱动的 PR);改动远程仓库并产出 PR;多进程编排,可从不同 worker 重新接入同一运行。
配置:CloudOptions 完整结构见 references/cloud-options;仓库引用、startingRef、existing-PR 模式见 references/repos;环境类型 env.type 可取 cloud、pool、machine,见 references/environments;会话环境变量见 references/env-vars;自动 PR 相关 autoCreatePR、workOnCurrentBranch、skipReviewerRequest 见 references/auto-pr。
输出:运行产生的 git 分支与 PR URL 见 references/git-info;产物通过 agent.listArtifacts() 与 downloadArtifact() 获取,见 references/artifacts。
生命周期:用 Agent.getRun(runId, { runtime: "cloud", agentId }) 重新接入,见 references/reattach;运行可跨断线存活,凭 agentId 与 runId 重连,见 references/durable-runs。
相关:本地模式见 ../cursor-sdk/references/local-options;运行接口见 ../cursor-runs/references/run-interface;错误处理见 ../cursor-errors/SKILL。
限制:资料未提供具体收费、价格、平台支持范围与配额信息。