1 min lesson
Choose the handoff starting point
Choose the repository state that a Cloud Agent can start from, then name the returned review path.
Step 1 of 2
A handoff is traceable when the pushed commit, cloud starting ref and separate returned branch form one readable chain.
A cloud handoff starts from repository state that the connected provider can reach. Commit and push the local edit, then record its branch and commit SHA. In the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition., choose Cloud and select that pushed starting branch. A default cloud run works on a separate cursor/... branch based on the selected ref. Review its test output, artifacts and draft pull request as new work. Fetch the returned branch locally, inspect every commit and rerun the checks that matter before merge.
- Entry point
- the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. Cloud target, starting branch, run details, artifacts and returned branch or draft pull request
- Source
- Cursor Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition. docs, Cloud Agents API docs, Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. changelog and June 2026 handoff changelog
Check Cloud selection, branch starting refs, separate cloud branches and draft pull request handoff in Cursor's current docs and changelog.