cursor-runs
cursor-runs
Everything you do after Agent.create flows through a Run. This skill covers how to issue work, stream events, await results, cancel, and inspect conversation history.
When to use
- Consuming streamed
SDKMessageevents - Implementing follow-up turns on the same agent
- Cancelling or reattaching to a long-running cloud run
- Parsing tool calls, thinking blocks, or assistant text
Sending work
- [[references/send]] —
agent.send(message, options)andSendOptions - [[references/send-options]] — per-run model override, MCP override, callbacks,
force - [[references/follow-ups]] — multi-turn conversations on one agent
Run object
More from hktitan/cursor-sdk
cursor-hooks
File-based agent loop hooks via `.cursor/hooks.json` — pre/post commands, governance gates. Use when enforcing policy without modifying agent prompts.
1cursor-subagents
Define delegated subagents on a Cursor SDK agent via the `agents` field — `AgentDefinition`, MCP scoping, and model inheritance. Use when decomposing work across specialist personas.
1cursor-sdk
Entry point for the Cursor TypeScript SDK — install, auth, and the Agent.create / Agent.resume / Agent.prompt lifecycle. Use when starting any Cursor SDK integration or wiring durable agent IDs.
1cursor-errors
CursorAgentError class hierarchy, isRetryable, and recovery patterns. Use when classifying SDK failures, building retry logic, or surfacing actionable messages.
1cursor-models
Model discovery and selection on Cursor SDK — Cursor.models.list, ModelSelection, parameters (e.g. thinking levels), per-run sticky overrides.
1cursor-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.
1