cursor-cloud

The cloud runtime gives each agent its own VM, persists across network drops, and can open PRs directly. Pass cloud (instead of local) on Agent.create.

When to use

• Long-running tasks (CI bots, scheduled refactors, kanban-driven PRs)
• Tasks that mutate a remote repo and produce a PR
• Multi-process orchestration where you reattach to a run from a different worker

Configuration

• [[references/cloud-options]] — full CloudOptions shape
• [[references/repos]] — repo refs, startingRef, existing-PR mode
• [[references/environments]] — env.type: "cloud", "pool", "machine"
• [[references/env-vars]] — session envVars
• [[references/auto-pr]] — autoCreatePR, workOnCurrentBranch, skipReviewerRequest

Outputs