Nous lançons le Cursor SDK pour vous permettre de créer des agents avec le même runtime, le même harness et les mêmes modèles qui font fonctionner Cursor.

Les agents qui s’exécutent dans l’application de bureau Cursor, le CLI et l’app web sont désormais accessibles avec quelques lignes de TypeScript. Exécutez-le sur votre machine ou dans le cloud de Cursor sur une VM dédiée, avec le modèle de pointe de votre choix.

Les agents de codage évoluent : d’outils interactifs pour les développeurs individuels, ils deviennent une infrastructure programmatique pour les organisations. Le Cursor SDK vous permet de déployer des agents sans avoir à créer et maintenir toute la stack d’agents. De nombreuses équipes appellent déjà des agents directement depuis des pipelines CI/CD, créent des automatisations pour des workflows de bout en bout et intègrent des agents au cœur de leurs produits.

Le Cursor SDK est désormais disponible en bêta publique pour tous les utilisateurs. Exécutez simplement npm install @cursor/sdk pour vous lancer.

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);
}

#Déployez rapidement des agents en production

Créer des agents de codage rapides, fiables et performants, capables de s’exécuter en toute sécurité avec vos données, demande un vrai travail d’ingénierie : sandboxing sécurisé, gestion durable de l’état et des sessions, configuration de l’environnement et gestion du contexte. Et lorsqu’un nouveau modèle sort, les équipes doivent souvent retravailler les boucles de leurs agents pour en tirer parti.

Le Cursor SDK élimine cette complexité pour vous permettre de vous concentrer sur la création d’agents utiles.

Utilisez une infrastructure cloud prête pour la production

Les sessions cloud lancées depuis le SDK s’exécutent sur le même runtime optimisé que celui que nous utilisons pour Agents Cloud. Chaque agent dispose de sa propre VM dédiée avec un sandboxing robuste, un clone du dépôt et un environnement de développement entièrement configuré.

Les agents continuent de fonctionner lorsque votre portable se met en veille ou que le réseau se coupe. Vous pouvez suivre la conversation en streaming et vous reconnecter plus tard. Lorsque l’agent a terminé, il peut ouvrir une PR, pousser une branche ou joindre des démos et des captures d’écran.

// Lancer un agent cloud pour démarrer une tâche... :
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...revenez vérifier plus tard, depuis n'importe où :
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

Le SDK utilise notre API des Agents Cloud mise à jour, ce qui permet aux exécutions d’agents cloud d’apparaître dans la fenêtre Agents de Cursor et dans l’application web. Vous pouvez démarrer une tâche par programmation, puis ouvrir Cursor pour suivre la progression ou reprendre la main.

Lorsque vous avez besoin d’un runtime différent, le même SDK peut exécuter des agents sur des workers auto-hébergés, tout en gardant le code et l’exécution des outils dans votre réseau, ou localement sur votre machine pour itérer rapidement.

Utilisez le harness complet de Cursor

Les agents lancés via le SDK bénéficient du même harness qui fait tourner Cursor sur notre application de bureau, notre CLI et notre application web :

• Gestion intelligente du contexte : l’indexation de la base de code, la recherche sémantique et Instant Grep aident les agents à aboutir plus vite, et plus efficacement, au bon résultat.
• Serveurs MCP : les agents peuvent se connecter à des outils externes et à des sources de données via stdio ou HTTP, soit à l’aide d’un fichier de configuration .cursor/mcp.json, soit en les passant directement dans l’appel.
• Skills : les agents récupèrent automatiquement les skills depuis le répertoire .cursor/skills/ de votre dépôt.
• Hooks : observez, contrôlez et étendez la boucle de l’agent dans le cloud, en auto-hébergé ou en local avec un fichier .cursor/hooks.json.
• Sous-agents : déléguez des sous-tâches à des sous-agents nommés avec leurs propres prompts et modèles, que l’agent principal lance via l’outil Agent.

Travaillez avec n’importe quel modèle

Le Cursor SDK vous donne accès à tous les modèles pris en charge dans Cursor. Orientez les agents vers le meilleur modèle pour la tâche à accomplir, selon l’équilibre coût/fonctionnalités recherché, en ne modifiant qu’un seul champ.

Et avec Composer 2, un modèle de codage spécialisé qui atteint des performances de niveau frontier pour une fraction du coût des modèles à usage général, vous obtenez la meilleure combinaison d’intelligence et d’efficacité pour la plupart des tâches d’agent de codage.

#Ce que les développeurs créent

Les équipes utilisent le Cursor SDK pour livrer plus rapidement des agents personnalisés. Par exemple, des agents programmatiques déclenchés directement depuis le CI/CD pour résumer les changements, identifier les causes racines des échecs CI et mettre à jour les PR avec des correctifs. D’autres créent des plateformes d’agents personnalisées, comme des applications internes qui permettent aux équipes GTM d’interroger les données produit sans écrire de code.

Certains clients intègrent même Cursor directement dans des produits destinés à leurs clients, où les utilisateurs finaux bénéficient désormais d’une expérience d’agent sans quitter l’application hôte.

Découvrez directement le témoignage de quelques-uns de nos clients qui créent avec le Cursor SDK :

#Partir d’un projet d’exemple

Nous avons ajouté quelques projets de départ dans un dépôt GitHub public que vous pouvez forker et étendre pour vos propres cas d’usage :

• Quickstart: Un exemple Node.js minimal qui crée un agent local, envoie un prompt et renvoie la réponse en continu.
• Outil de prototypage: Une application web pour lancer des agents afin de poser les bases de nouveaux projets et d’itérer sur des idées dans un environnement cloud isolé.
• Tableau kanban: Un outil kanban piloté par des agents, dans lequel les ingénieurs peuvent faire glisser une carte et laisser les agents prendre automatiquement la tâche en charge, ouvrir une PR, puis renvoyer le résultat sous forme de pièce jointe.
• CLI d’agent de codage: Une interface en ligne de commande légère qui vous permet de lancer des agents Cursor depuis votre terminal.

#Et ensuite

Le Cursor SDK est disponible pour tous les utilisateurs et est facturé selon la tarification standard à l’usage, basée sur les tokens.

Nous continuons d’investir dans le Cursor SDK afin de le rendre encore plus simple pour les équipes qui créent des agents programmatiques dans davantage de langages, de workflows et de patterns de déploiement.

Pour en savoir plus, consultez notre documentation. Vous pouvez aussi utiliser Cursor avec notre plugin Cursor SDK pour commencer plus facilement à créer.