# Cursor Cloud

> Cloud runtime for Cursor SDK — dedicated VMs, repo-bound runs, auto-PR creation, artifacts, and reattachment. Use when running long, review-oriented, or repo-modifying agents off the local machine.

- Skill: `hktitan/cursor-cloud` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add hktitan/cursor-cloud`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/cursor-cloud/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/cursor-cloud

---


# 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

- [[references/git-info]] — `run.git` branches and PR URLs
- [[references/artifacts]] — `agent.listArtifacts()` and `downloadArtifact()`

## Lifecycle

- [[references/reattach]] — `Agent.getRun(runId, { runtime: "cloud", agentId })`
- [[references/durable-runs]] — runs survive disconnects; reattach with `agentId`+`runId`

## Cross-links

- Local mode → [[../cursor-sdk/references/local-options]]
- Run interface → [[../cursor-runs/references/run-interface]]
- Errors → [[../cursor-errors/SKILL]]