Cursor SDK : construire un agent et l'exécuter

Par:
francoistonic

jeu, 30/04/2026 - 07:29

Cursor SDK permet de créer un agent, sur le même runtime que Cursor. L'agent pourra alors tourner sur l'app Cursor, la CLI, une web app et il sera accessible avec quelques lignes de codes. Il peut tourner localement ou sur le cloud. Le SDK est maintenant en version bêta publique. 

Installation : npm install @curosr/sdk

On le déclare : 

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
apiKey: process.env.CURSOR_API_KEY!,
model: { id: "composer-2" },
local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
console.log(event);
}

Cursor SDK a l'ambition de réduire la complexité de création d'un agent. Comme le socle technique est celui de Curosr, on accède aux fonctions avancées : contexte, MCP, Skills, Hooks, subagent. On accéde aux modèles utilisés par Cursor. Un des usages est de créer un agent programmatique. 

Comment démarrer ? 

Le GitHub fournit les éléments nécessaires. Plusieurs exemples sont accessibles :

- Quickstart : pour créer un agent minimal

- outil de prototypage

- tableau Kanban

- agent de codage en CLI

La tarification se fera sur la consommation des tokens. 

Annonce : https://cursor.com/blog/typescript-sdk