Cursor

Le fournisseur Cursor fait tourner l’agent de Cursor sur la machine du relais, via le Cursor Agent SDK. OAR démarre un processus worker par conversation. L’agent travaille dans le dossier de travail de la conversation, avec les modèles de votre compte Cursor. Contrairement à Claude, il n’utilise pas de connexion sur la machine : vous donnez à OAR une clé d’API Cursor.

Cette page couvre ce qui est propre à Cursor. Le chat, la queue et l’explorateur de fichiers fonctionnent comme pour tous les fournisseurs ; voir Les fournisseurs en un coup d’œil pour comparer Cursor aux autres.

Ce qu’il vous faut #

• Une clé d’API Cursor. Vous la collez une fois dans OAR ; voir L’activer.
• Rien à installer. Cursor n’a besoin ni d’une CLI ni de l’app Cursor sur la machine, si bien que le sous-onglet Cursor n’a pas de ligne CLI.

Où se trouvent les choses :

Par défaut, les dossiers d’état se trouvent sous cursor-agents dans le dossier de données du relais : ~/.oar/data/cursor-agents (%APPDATA%\oar\data\cursor-agents sous Windows) sur une installation globale, server/data/cursor-agents dans un checkout git. Ajouté en 0.9.14 Avant 0.9.14, une installation globale les gardait dans le dossier du paquet, qu’une mise à jour remplace, si bien qu’une conversation pouvait perdre son agent ; une conversation dont le dossier existe encore continue de l’utiliser. CURSOR_AGENT_STORE_DIR les déplace ; voir Variables d’environnement.

L’activer #

Ouvrez Settings → Providers → Cursor (Réglages → Fournisseurs → Cursor). Le panneau a pour titre Cursor SDK.

La ligne d’état sous les champs indique où vous en êtes :

Ce que fait l’enregistrement :

• Découverte des modèles. Quand Cursor est activé et que vous enregistrez une nouvelle clé, changez le modèle ou le réactivez, OAR demande à Cursor les modèles que votre clé peut utiliser, et les options de raisonnement de chaque modèle. La requête abandonne au bout de 20 secondes. Un échec apparaît comme un avertissement dans l’avis affiché, par exemple Cursor model discovery failed: …. Tant qu’aucune découverte n’a réussi, la liste ne contient que le modèle par défaut.
• Changer de clé. Enregistrer une nouvelle clé efface les modèles découverts et, si Cursor est activé, relance la découverte. Quand une clé était déjà enregistrée, le relais arrête aussi tous les workers Cursor, y compris un worker en plein turn ; enregistrez donc une nouvelle clé entre deux turns. Les workers redémarrent avec la nouvelle clé au message suivant.
• Supprimer la clé est refusé tant qu’une conversation Cursor a envoyé un message ou a des messages en file : Cannot remove Cursor API key while N active Cursor conversation(s) still exist. Disable Cursor for new conversations instead. Aucun turn en cours n’est donc touché par une suppression. Désactivez plutôt Cursor. Quand la suppression aboutit, les conversations qui n’ont pas encore envoyé de message repassent sur Copilot. Désactiver Cursor ne les déplace pas.

Démarrez ensuite une conversation comme d’habitude : dans New Chat, choisissez le fournisseur Cursor SDK. Voir Démarrer une conversation.

Modèles et effort #

D’où vient la liste. De Cursor lui-même, via votre clé, aux moments indiqués ci-dessus. 🤗 Select Models → Cursor SDK (Sélectionner des modèles → Cursor SDK) choisit lesquels la zone de saisie propose ; 💾 Save enabled models (Enregistrer les modèles activés) conserve le choix, et Refresh (Actualiser) relance la découverte. Sans choix, tous les modèles découverts sont proposés. Le modèle de Cursor model ID est toujours proposé.

Par message. Une conversation peut changer de modèle et d’effort d’un message à l’autre ; les ID de modèle Cursor s’utilisent tels que Cursor les écrit. Un ID qui ne figure pas parmi les modèles qui vous sont proposés (ceux qui sont activés, plus Cursor model ID et le modèle propre à la conversation) est refusé avec Cursor model "…" is not available.

Effort. Les choix d’effort viennent du modèle, tels qu’il les liste. OAR connaît ces niveaux : none, low, medium, high, xhigh et max. Le extra-high de Cursor apparaît comme xhigh. Un niveau qu’OAR ne connaît pas n’est pas proposé.

• none est toujours dans la liste. Si le modèle peut désactiver le raisonnement, none le fait. S’il ne le peut pas, la zone de saisie affiche l’entrée comme default (Par défaut), et le modèle tourne comme d’habitude.
• Un modèle qui ne liste aucun effort n’a que none, affiché comme default.
• Sur un modèle qui a un interrupteur de thinking, choisir un niveau active le thinking et none le désactive.

Des subagents sur d’autres modèles. Le menu de subagents intégré de Cursor ne propose que quelques modèles. OAR déclare donc un subagent par modèle que vous avez activé dans Select Models, pour que l’agent puisse confier une tâche, par exemple, à un modèle Grok ou GPT. Les noms utilisent des tirets (grok-4.5 devient grok-4-5). Un subagent fait tourner la variante par défaut de son modèle : on ne peut pas lui donner d’effort. Un changement de sélection prend effet au message suivant.

Comment les fonctionnalités d’OAR fonctionnent sur Cursor #

Les règles de projet, les fichiers de subagents et les serveurs MCP propres à Cursor, dans le dossier .cursor du dossier de travail, ne sont pas chargés. OAR définit lui-même les outils et les subagents de l’agent.

Un agent longtemps inactif #

Un agent Cursor inutilisé depuis 30 minutes est fermé puis rouvert au message suivant, car sa connexion devient périmée après quelques heures d’inactivité. Vous ne le voyez pas. Si la connexion est malgré tout devenue périmée, OAR reconstruit l’agent et renvoie le message, jusqu’à deux fois, et ajoute la ligne d’activité Cursor session re-authenticated; retrying this message on a fresh agent handle. Un troisième échec termine le turn avec le message de connexion décrit dans Si ça ne marche pas.

Consommation #

Les turns Cursor n’ont pas de ligne de consommation sous la réponse. 📊 Check Usage (Vérifier la consommation) a une carte Cursor. Tant que Cursor est désactivé, elle indique Cursor is not enabled in provider settings. Ses chiffres viennent de deux sources, et la carte indique celle qu’elle a utilisée.

Dépenses selon OAR, une estimation. Après chaque turn, OAR lit auprès de Cursor les dépenses facturées de l’agent et inscrit la hausse au cycle de facturation en cours. Il range chaque turn dans l’enveloppe du modèle qui l’a exécuté :

La comparaison ignore la casse, et les noms de routeur sont vérifiés en premier.

Cursor n’indique pas au SDK ce que votre forfait inclut. C’est vous qui le saisissez :

Les jauges mesurent le coût brut des modèles par rapport à votre allocation. La carte liste aussi ce que Cursor a réellement facturé, souvent zéro pour un usage inclus dans le forfait. Tous ces chiffres sont des estimations. Un coût que Cursor signale en retard est inscrit avec le turn qui le voit. Le tableau de bord Spending de Cursor fait foi, et la carte y renvoie.

Barres du forfait en direct, depuis le tableau de bord. Avec un token de session du tableau de bord, la carte ajoute les barres Plan usage (total) (Consommation du forfait, total), Auto + Composer et API, lues en direct sur le tableau de bord de Cursor, le nom du forfait, les dépenses incluses et à la demande, et les vraies dates du cycle. Les jauges locales des enveloppes passent alors au second plan. Le token est un cookie de session, pas la clé d’API, et la clé d’API ne peut pas lire ces chiffres.

OAR cherche un token dans cet ordre :

1. Celui que vous avez enregistré.
2. CURSOR_SESSION_TOKEN dans l’environnement du relais, pour les hôtes sans app Cursor.
3. La connexion de l’app Cursor sur la machine du relais, lue dans son état local, sans configuration.

La ligne d’état sous le champ nomme la source utilisée. Le token reste sur le relais et n’est jamais envoyé à un navigateur. Si Cursor n’accepte pas le token, la carte revient aux estimations et indique quelle source a été refusée, ou qu’aucun token n’a été trouvé.

Un agent peut lire les mêmes chiffres avec l’action usage de relay_tool.

Variables d’environnement #

Définissez-les dans l’environnement dans lequel le relais démarre.

La clé d’API ne peut pas être définie de cette façon : le relais passe à ses workers la clé du panneau et ignore un CURSOR_API_KEY dans son propre environnement.

Limites #

Au-delà des manques du tableau ci-dessus (pas de pilotage, pas de panneau des tâches, pas de réglage du compactage, un seul niveau de subagents) :

• Les cartes de question dépendent de l’appel de ask_user par l’agent.
• Les dépenses et les allocations sont des estimations. Seules les barres du tableau de bord viennent de Cursor.
• Une limite d’utilisation de votre forfait Cursor ne met pas la conversation en pause. Le turn échoue comme tout turn échoué, et vous renvoyez le message.

Si ça ne marche pas #