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 alimentent Cursor.
Les agents qui s’exécutent dans l’application de bureau Cursor, la CLI et l’application web sont désormais accessibles avec quelques lignes de TypeScript. Exécutez-les sur votre machine ou dans le cloud de Cursor sur une VM dédiée, avec n’importe quel modèle de pointe.
Exécutez npm install @cursor/sdk pour commencer. Vous pouvez également utiliser la skill native /sdk de Cursor pour vous aider à démarrer.
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);}
Nous avons créé quelques projets d’exemple, auxquels vous pouvez accéder depuis un dépôt public. Forkez-les et adaptez-les à votre propre cas d’usage.
Le Cursor SDK est désormais disponible pour tous les utilisateurs en bêta publique, avec une tarification standard basée sur la consommation de tokens. Pour en savoir plus, consultez notre annonce et notre documentation.
Refonte de l’API autour d’agents durables et d’exécutions par prompt, de sorte que le suivi, le statut, le streaming et l’annulation sont désormais rattachés à l’exécution.
Ajout d’un streaming d’exécution natif avec des événements SSE, la prise en charge de la reconnexion via Last-Event-ID et des états terminaux plus clairs.
Ajout de contrôles explicites du cycle de vie des agents, avec archivage, désarchivage et suppression définitive.
Standardisation des formats de réponse et d’erreur v1, avec notamment des codes d’erreur structurés, des réponses de liste items et des objets agent / run distincts.
Cette version introduit une nouvelle manière de travailler en parallèle grâce aux sous-agents asynchrones, à une expérience améliorée des worktrees et aux espaces de travail multi-racine pour effectuer des modifications sur plusieurs dépôts.
Avec /multitask, Cursor exécutera des sous-agents asynchrones pour traiter vos requêtes en parallèle au lieu de les ajouter à la file d’attente. Il décomposera aussi les tâches plus importantes en sous-tâches plus petites qu’une flotte de sous-agents asynchrones prendra en charge simultanément.
Si vous avez déjà des messages dans la file d’attente, vous pouvez aussi demander à Cursor de les traiter en parallèle, au lieu d’attendre la fin de l’exécution en cours.
Exécutez des tâches isolées en arrière-plan sur différentes branches. Quand vous êtes prêt à tester les modifications, ramenez n’importe quelle branche au premier plan en local en un clic.
#Espaces de travail multi-racine dans la fenêtre Agents
Une même session d’agent peut désormais cibler un espace de travail réutilisable composé de plusieurs dossiers.
Cursor peut ainsi effectuer des modifications sur plusieurs dépôts — frontend, backend et bibliothèques partagées — sans devoir redéfinir la cible de l’agent chaque fois qu’il passe d’un dépôt à l’autre.
Ces visualisations peuvent inclure des tableaux de bord et des interfaces personnalisées créés à l’aide de composants natifs tels que des tableaux, des boîtes, des diagrammes et des graphiques, ainsi que de composants Cursor existants comme les diffs et les listes de tâches.
Dans la fenêtre Agents, les canevas sont des artefacts durables qui se trouvent dans le panneau latéral, aux côtés du terminal, du Browser et de la gestion du code source.
Essayez-les dans Cursor 3.1 dans la fenêtre Agents ou l’éditeur. Pour en savoir plus, consultez notre annonce.
Utilisez /debug pour identifier les causes racines et corriger des bugs difficiles à reproduire ou à comprendre. En mode Debug, Cursor génère des hypothèses, ajoute des instructions de journalisation et utilise les données d'exécution pour cerner précisément le problème avant d'apporter une correction ciblée.
Posez rapidement une question annexe sans détourner l’agent de sa tâche principale. /btw vous permet d’obtenir des éclaircissements sur les modifications apportées par Cursor sans interrompre l’exécution en cours.
/config ouvre un panneau interactif des paramètres dans le CLI, où vous pouvez consulter et modifier différents réglages, comme le choix des modèles, les valeurs par défaut, les préférences d’exécution, et bien plus encore.
Vous pouvez aussi demander à Cursor d’appliquer ces modifications de configuration pour vous à l’aide de la skill /update-cli-config.
Personnalisez la barre d’état à l’aide de /statusline pour afficher les signaux de session et d’exécution qui vous importent, notamment le mode actuel, la branche, l’environnement, des indications sur la tâche active ou d’autres métadonnées de session.
Déclenchez le sélecteur de modèles depuis n’importe où pour changer de modèle sans avoir à effacer d’abord votre prompt.
Si Cursor repère que vous avez activé Auto-Run trois fois d’affilée, il vous suggérera désormais de l’activer automatiquement pour éviter les boucles d’approbation interminables.
L’outil AskQuestion et le mode Debug gèrent désormais plus naturellement les réponses en texte brut.
Le collage d’images depuis le presse-papiers est désormais pris en charge, y compris avec Ctrl+V dans certains terminaux sans fonction de collage native.
Le pied de page indique désormais votre répertoire de travail, votre worktree et votre branche actuelle.
Vous pouvez désormais envoyer la CLI en arrière-plan de façon fiable avec Ctrl+Z.
Auto-Run fonctionne désormais dans d’autres modes, comme le mode Debug et le mode Plan.
Correction d’un problème où des processus shell en arrière-plan pouvaient continuer à s’exécuter après avoir quitté la CLI.
Correction de la gestion et de la correspondance des commandes slash.
Correction de la gestion du clavier pour Cmd+Delete, les raccourcis clavier Vim et les combinaisons avec le modificateur Ctrl.
Divisez votre vue actuelle en volets pour lancer et gérer plusieurs agents en parallèle. La disposition en mosaïque facilite le multitâche et la comparaison des résultats entre les agents, sans passer d’un onglet à l’autre.
Agrandissez les volets pour vous concentrer sur une conversation, faites glisser des agents dans les tuiles et utilisez des raccourcis clavier pour naviguer et organiser rapidement. Cette configuration est également conservée d’une session à l’autre.
La dictée avec la saisie vocale est désormais plus fiable et plus précise. Elle enregistre l’intégralité de votre enregistrement vocal et le transcrit par lots avec le STT, pour une reconnaissance parole-texte de meilleure qualité.
Vous pouvez maintenir Ctrl+M enfoncé pour parler, et nous avons ajouté des contrôles dans l’interface pendant l’enregistrement, comme une forme d’onde, un chronomètre, ainsi que des boutons pour annuler et confirmer.
Auparavant, lorsque vous démarriez un agent depuis l’état vide, votre branche actuelle était généralement sélectionnée par défaut. Vous pouvez désormais rechercher et sélectionner d’abord une branche, puis lancer directement un agent cloud sur cette branche.
Cela évite des étapes supplémentaires pour changer de branche et réduit les exécutions accidentelles sur la mauvaise branche.
Passez directement du diff à la ligne exacte dans le fichier. Une fois sur place, vous bénéficiez de toute la puissance de l’éditeur : modifiez le code manuellement, utilisez Tab, accédez à la définition, et bien plus encore.
Utilisez les filtres d’inclusion/exclusion dans "Search in Files" pour limiter la recherche de code à des ensembles de fichiers spécifiques.
Les boutons de prompt restent désormais en place pendant le traitement de la saisie vocale.
Les onglets de plan bénéficient désormais des mêmes comportements de document que les fichiers : chargement fiable, suivi des modifications non enregistrées, rechargement lors des changements de plan, et possibilité d’enregistrer, copier et exporter du Markdown.
Les nouvelles sessions d’agent démarrent désormais par défaut sur votre cible de projet préférée.
Les noms des onglets de fichiers sont désormais résolus parmi les onglets visibles de l’agent actuel, au lieu d’essayer d’être globalement uniques parmi les onglets de tous les autres agents.
Cmd-K affiche désormais moins de résultats d’agent, mais plus pertinents, limités à l’ensemble récent correspondant (c.-à-d. les éléments qui correspondent à votre requête et proviennent d’un sous-ensemble récent).
Sur macOS, le texte est désormais rendu avec anticrénelage, pour des contours de caractères plus nets.
Le mode Design permet désormais de naviguer dans l’arborescence des éléments (vers le haut, le bas et sur les côtés) au clavier afin de sélectionner l’élément d’interface avant de commenter.
La fenêtre des agents évite désormais les mises à jour et récupérations coûteuses, sauf lorsqu’elles sont réellement nécessaires.
La fermeture des onglets perturbe désormais moins souvent l’arborescence des fichiers, et la récupération est plus rapide.
Les récupérations locales de diff ont été limitées afin de réduire les pics d’utilisation CPU/réseau et les ralentissements dans les vues SCM.
L’arborescence des fichiers réagit désormais plus fiablement aux changements et risque moins de scintiller, d’afficher des données obsolètes ou de manquer des mises à jour.
Les événements d’extension (par ex. changement de fichier, mise à jour des diagnostics) sont désormais limités à chaque espace de travail, ce qui réduit les interférences entre projets.
Appuyer sur Entrée pour envoyer un message de suivi dans une longue conversation provoquait auparavant un blocage de plus d’une seconde ; c’est désormais instantané.
Les modifications volumineuses s’affichent désormais de manière plus fluide, avec une réduction d’environ 87 % du nombre d’images perdues.
Correction d’un bug qui faisait saccader le défilement dans les longues conversations. Il est désormais fluide, même dans les fils volumineux.
Correction d’un bug qui faisait clignoter et figer une conversation d’agent remplie de diffs ou de blocs de code.
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 alimentent Cursor.
Les agents qui s’exécutent dans l’application de bureau Cursor, la CLI et l’application web sont désormais accessibles avec quelques lignes de TypeScript. Exécutez-les sur votre machine ou dans le cloud de Cursor sur une VM dédiée, avec n’importe quel modèle de pointe.
Exécutez npm install @cursor/sdk pour commencer. Vous pouvez également utiliser la skill native /sdk de Cursor pour vous aider à démarrer.
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);}
Nous avons créé quelques projets d’exemple, auxquels vous pouvez accéder depuis un dépôt public. Forkez-les et adaptez-les à votre propre cas d’usage.
Le Cursor SDK est désormais disponible pour tous les utilisateurs en bêta publique, avec une tarification standard basée sur la consommation de tokens. Pour en savoir plus, consultez notre annonce et notre documentation.
Refonte de l’API autour d’agents durables et d’exécutions par prompt, de sorte que le suivi, le statut, le streaming et l’annulation sont désormais rattachés à l’exécution.
Ajout d’un streaming d’exécution natif avec des événements SSE, la prise en charge de la reconnexion via Last-Event-ID et des états terminaux plus clairs.
Ajout de contrôles explicites du cycle de vie des agents, avec archivage, désarchivage et suppression définitive.
Standardisation des formats de réponse et d’erreur v1, avec notamment des codes d’erreur structurés, des réponses de liste items et des objets agent / run distincts.
Cette version introduit une nouvelle manière de travailler en parallèle grâce aux sous-agents asynchrones, à une expérience améliorée des worktrees et aux espaces de travail multi-racine pour effectuer des modifications sur plusieurs dépôts.
Avec /multitask, Cursor exécutera des sous-agents asynchrones pour traiter vos requêtes en parallèle au lieu de les ajouter à la file d’attente. Il décomposera aussi les tâches plus importantes en sous-tâches plus petites qu’une flotte de sous-agents asynchrones prendra en charge simultanément.
Si vous avez déjà des messages dans la file d’attente, vous pouvez aussi demander à Cursor de les traiter en parallèle, au lieu d’attendre la fin de l’exécution en cours.
Exécutez des tâches isolées en arrière-plan sur différentes branches. Quand vous êtes prêt à tester les modifications, ramenez n’importe quelle branche au premier plan en local en un clic.
#Espaces de travail multi-racine dans la fenêtre Agents
Une même session d’agent peut désormais cibler un espace de travail réutilisable composé de plusieurs dossiers.
Cursor peut ainsi effectuer des modifications sur plusieurs dépôts — frontend, backend et bibliothèques partagées — sans devoir redéfinir la cible de l’agent chaque fois qu’il passe d’un dépôt à l’autre.
Ces visualisations peuvent inclure des tableaux de bord et des interfaces personnalisées créés à l’aide de composants natifs tels que des tableaux, des boîtes, des diagrammes et des graphiques, ainsi que de composants Cursor existants comme les diffs et les listes de tâches.
Dans la fenêtre Agents, les canevas sont des artefacts durables qui se trouvent dans le panneau latéral, aux côtés du terminal, du Browser et de la gestion du code source.
Essayez-les dans Cursor 3.1 dans la fenêtre Agents ou l’éditeur. Pour en savoir plus, consultez notre annonce.
Utilisez /debug pour identifier les causes racines et corriger des bugs difficiles à reproduire ou à comprendre. En mode Debug, Cursor génère des hypothèses, ajoute des instructions de journalisation et utilise les données d'exécution pour cerner précisément le problème avant d'apporter une correction ciblée.
Posez rapidement une question annexe sans détourner l’agent de sa tâche principale. /btw vous permet d’obtenir des éclaircissements sur les modifications apportées par Cursor sans interrompre l’exécution en cours.
/config ouvre un panneau interactif des paramètres dans le CLI, où vous pouvez consulter et modifier différents réglages, comme le choix des modèles, les valeurs par défaut, les préférences d’exécution, et bien plus encore.
Vous pouvez aussi demander à Cursor d’appliquer ces modifications de configuration pour vous à l’aide de la skill /update-cli-config.
Personnalisez la barre d’état à l’aide de /statusline pour afficher les signaux de session et d’exécution qui vous importent, notamment le mode actuel, la branche, l’environnement, des indications sur la tâche active ou d’autres métadonnées de session.
Déclenchez le sélecteur de modèles depuis n’importe où pour changer de modèle sans avoir à effacer d’abord votre prompt.
Si Cursor repère que vous avez activé Auto-Run trois fois d’affilée, il vous suggérera désormais de l’activer automatiquement pour éviter les boucles d’approbation interminables.
L’outil AskQuestion et le mode Debug gèrent désormais plus naturellement les réponses en texte brut.
Le collage d’images depuis le presse-papiers est désormais pris en charge, y compris avec Ctrl+V dans certains terminaux sans fonction de collage native.
Le pied de page indique désormais votre répertoire de travail, votre worktree et votre branche actuelle.
Vous pouvez désormais envoyer la CLI en arrière-plan de façon fiable avec Ctrl+Z.
Auto-Run fonctionne désormais dans d’autres modes, comme le mode Debug et le mode Plan.
Correction d’un problème où des processus shell en arrière-plan pouvaient continuer à s’exécuter après avoir quitté la CLI.
Correction de la gestion et de la correspondance des commandes slash.
Correction de la gestion du clavier pour Cmd+Delete, les raccourcis clavier Vim et les combinaisons avec le modificateur Ctrl.
Divisez votre vue actuelle en volets pour lancer et gérer plusieurs agents en parallèle. La disposition en mosaïque facilite le multitâche et la comparaison des résultats entre les agents, sans passer d’un onglet à l’autre.
Agrandissez les volets pour vous concentrer sur une conversation, faites glisser des agents dans les tuiles et utilisez des raccourcis clavier pour naviguer et organiser rapidement. Cette configuration est également conservée d’une session à l’autre.
La dictée avec la saisie vocale est désormais plus fiable et plus précise. Elle enregistre l’intégralité de votre enregistrement vocal et le transcrit par lots avec le STT, pour une reconnaissance parole-texte de meilleure qualité.
Vous pouvez maintenir Ctrl+M enfoncé pour parler, et nous avons ajouté des contrôles dans l’interface pendant l’enregistrement, comme une forme d’onde, un chronomètre, ainsi que des boutons pour annuler et confirmer.
Auparavant, lorsque vous démarriez un agent depuis l’état vide, votre branche actuelle était généralement sélectionnée par défaut. Vous pouvez désormais rechercher et sélectionner d’abord une branche, puis lancer directement un agent cloud sur cette branche.
Cela évite des étapes supplémentaires pour changer de branche et réduit les exécutions accidentelles sur la mauvaise branche.
Passez directement du diff à la ligne exacte dans le fichier. Une fois sur place, vous bénéficiez de toute la puissance de l’éditeur : modifiez le code manuellement, utilisez Tab, accédez à la définition, et bien plus encore.
Utilisez les filtres d’inclusion/exclusion dans "Search in Files" pour limiter la recherche de code à des ensembles de fichiers spécifiques.
Les boutons de prompt restent désormais en place pendant le traitement de la saisie vocale.
Les onglets de plan bénéficient désormais des mêmes comportements de document que les fichiers : chargement fiable, suivi des modifications non enregistrées, rechargement lors des changements de plan, et possibilité d’enregistrer, copier et exporter du Markdown.
Les nouvelles sessions d’agent démarrent désormais par défaut sur votre cible de projet préférée.
Les noms des onglets de fichiers sont désormais résolus parmi les onglets visibles de l’agent actuel, au lieu d’essayer d’être globalement uniques parmi les onglets de tous les autres agents.
Cmd-K affiche désormais moins de résultats d’agent, mais plus pertinents, limités à l’ensemble récent correspondant (c.-à-d. les éléments qui correspondent à votre requête et proviennent d’un sous-ensemble récent).
Sur macOS, le texte est désormais rendu avec anticrénelage, pour des contours de caractères plus nets.
Le mode Design permet désormais de naviguer dans l’arborescence des éléments (vers le haut, le bas et sur les côtés) au clavier afin de sélectionner l’élément d’interface avant de commenter.
La fenêtre des agents évite désormais les mises à jour et récupérations coûteuses, sauf lorsqu’elles sont réellement nécessaires.
La fermeture des onglets perturbe désormais moins souvent l’arborescence des fichiers, et la récupération est plus rapide.
Les récupérations locales de diff ont été limitées afin de réduire les pics d’utilisation CPU/réseau et les ralentissements dans les vues SCM.
L’arborescence des fichiers réagit désormais plus fiablement aux changements et risque moins de scintiller, d’afficher des données obsolètes ou de manquer des mises à jour.
Les événements d’extension (par ex. changement de fichier, mise à jour des diagnostics) sont désormais limités à chaque espace de travail, ce qui réduit les interférences entre projets.
Appuyer sur Entrée pour envoyer un message de suivi dans une longue conversation provoquait auparavant un blocage de plus d’une seconde ; c’est désormais instantané.
Les modifications volumineuses s’affichent désormais de manière plus fluide, avec une réduction d’environ 87 % du nombre d’images perdues.
Correction d’un bug qui faisait saccader le défilement dans les longues conversations. Il est désormais fluide, même dans les fils volumineux.
Correction d’un bug qui faisait clignoter et figer une conversation d’agent remplie de diffs ou de blocs de code.
