---
title: "Build programmatic agents with the Cursor SDK"
description: "Cursor’s SDK is now in public beta, letting developers build programmatic coding agents with the runtime, harness, and models used by Cursor’s desktop app, CLI, and web app through TypeScript. Agents can run locally, on Cursor’s cloud in dedicated VMs, or on self-hosted workers; cloud sessions include a repository clone, configured development environment, streaming, reconnection, and options to push branches or open pull requests. The SDK also provides codebase indexing, semantic search, grep, MCP servers, repository skills, hooks, and named subagents, while supporting every model available in Cursor, including Composer 2.5. Described uses include CI/CD automations, custom internal platforms, and customer-facing agent experiences, with starter projects for quickstarts, prototyping, kanban workflows, and a CLI; the SDK uses standard token-based consumption pricing."
---

# Build programmatic agents with the Cursor SDK

[Cursor](https://yomu.fyi/company/cursor) · Roshan Sadanani · Apr 29, 2026

**Type:** Announcement

## Summary

Cursor’s SDK is now in public beta, letting developers build programmatic coding agents with the runtime, harness, and models used by Cursor’s desktop app, CLI, and web app through TypeScript. Agents can run locally, on Cursor’s cloud in dedicated VMs, or on self-hosted workers; cloud sessions include a repository clone, configured development environment, streaming, reconnection, and options to push branches or open pull requests. The SDK also provides codebase indexing, semantic search, grep, MCP servers, repository skills, hooks, and named subagents, while supporting every model available in Cursor, including Composer 2.5. Described uses include CI/CD automations, custom internal platforms, and customer-facing agent experiences, with starter projects for quickstarts, prototyping, kanban workflows, and a CLI; the SDK uses standard token-based consumption pricing.

## Context

Teams increasingly invoke coding agents from CI/CD pipelines, use them in end-to-end automations, and embed them in products. Building reliable agents that safely access data requires engineering for sandboxing, state and session management, environment setup, context management, and model updates.

## Approach / What changed

The Cursor SDK exposes Cursor’s existing runtime, harness, and supported models through a TypeScript package. It supports local, cloud, and self-hosted execution, with cloud agents running in dedicated VMs and providing repository setup, streaming, reconnection, and Git workflow integrations.

## Takeaways

- Cloud SDK sessions run in dedicated VMs with a repository clone and configured development environment, and can continue while a laptop sleeps or a network connection drops.
- The SDK exposes Cursor harness features including codebase indexing, semantic search, MCP servers, repository skills, hooks, and named subagents.
- Starter projects cover a minimal Node.js quickstart, cloud prototyping, an agent-powered kanban board, and a coding-agent CLI; usage is billed through standard token-based pricing.

**Tags:** [AI Agents](https://yomu.fyi/topic/ai-agents), [CI/CD](https://yomu.fyi/topic/ci-cd), [Cursor](https://yomu.fyi/topic/cursor)

- Source: [Cursor](https://cursor.com/blog/typescript-sdk)
- Source URL: https://cursor.com/blog/typescript-sdk
- Ingested by Yomu: 2026-09-02T11:42:57.702Z

[Read original post](https://cursor.com/blog/typescript-sdk)