Cursor åpner SDK-en sin: bygg agenter med samme runtime som Composer-2

«The agents that run in the Cursor desktop app, CLI, and web app are now accessible with a few lines of TypeScript.» — Cursor, changelog 29. april

Cursor har gjort tilgjengelig en programmatisk inngang til agentene som hittil bare kunne kjøres via desktop-appen, CLI-en og web-appen. SDK-en er publisert som npm-pakken @cursor/sdk og dekker hele lifecycle-en til en agent: opprettelse, prompt-strømming over Server-Sent Events, status-polling, kansellering og arkivering. Du sender inn en apiKey, peker mot composer-2 (eller en annen frontier-modell), og bestemmer om agenten skal kjøre med local: { cwd } mot din egen filsystem eller mot en dedikert Cursor-VM med repoet allerede klonet.

API-et er reorganisert rundt to begreper Cursor kaller «durable agents» og «per-prompt runs». Agenten lever videre mellom kall. Hvert prompt blir en egen run med sine egne SSE-events, sin egen status og en Last-Event-ID du kan bruke til å reconnecte hvis forbindelsen faller. Det betyr at du kan bygge en kø-prosessor som plukker opp pågående runs etter en restart uten å miste tilstand.

For norske byggere er den umiddelbart interessante delen sky-modusen. Cursors sky-VM får repoet allerede klonet og leverer en isolert sandkasse per run, så du kan parallellisere agenter mot samme repo uten å låse din egen maskin. Det skiller seg fra hvordan man typisk har kjørt Aider, Claude Code eller Devin-style agenter, der du må holde et lokalt environment åpent for hele kjøringen.

Pris er token-basert «standard consumption», ikke en flat månedssum. Det gjør SDK-en lett å eksperimentere med for hobbyprosjekter, men koster fort hvis du setter en støyete pipeline til å kjøre Composer-2 på hver PR. SDK-en er foreløpig i offentlig beta.

Hva bør du gjøre?

Installer pakken og kjør et lite eksempel mot din egen kodebase før du integrerer mot CI. npm install @cursor/sdk, sett CURSOR_API_KEY, og test mot et trygt repo.
Vurder sky-VM kontra lokal modus. Lokal er enklere for personlige skript. Sky-VM er bedre når du vil kjøre flere parallelle agenter eller integrere mot en server uten Cursor-app installert.
Sett en spending limit i Cursor-dashbordet. Token-basert pris kombinert med Composer-2 kan løpe fort hvis en agent kjører i loop. Begrens før du finner ut det på fakturaen.