Cursor SDK Now Available: Build Agents with TypeScript
Cursor SDK is now in public beta. Build agents with TypeScript using the same runtime and models that power Cursor's desktop and CLI. Token-based pricing, cloud or local execution.
TL;DR
- Cursor SDK is now in public beta — build agents programmatically with TypeScript
- Run agents locally or on Cursor's cloud infrastructure with any frontier model
- Cloud Agents API redesigned for better streaming, lifecycle control, and error handling
New
- Cursor SDK (TypeScript) — Access the same runtime and models powering Cursor's desktop, CLI, and web apps. Install with
npm install @cursor/sdkand start building agents in minutes. - Cloud Agents API v1 — Reworked around durable agents and per-prompt runs with first-class SSE streaming, reconnect support via
Last-Event-ID, and explicit lifecycle controls (archive, unarchive, delete). - Run-scoped operations — Follow-ups, status checks, streaming, and cancellation now operate at the run level for clearer state management.
- Standardized responses — v1 API now includes structured error codes,
itemslist responses, and separateagent/runobjects.
Getting Started
- Token-based consumption pricing applies. Check the SDK docs and announcement for details.
- Fork sample projects from the public cookbook repo to jumpstart your use case.
- Use the Cursor SDK plugin to get IDE assistance while building.
Update: Run npm install @cursor/sdk to get started.
Source: Cursor