Utiliser Cursor Agent : lancer une tâche repo et relire les diffs

Ouvrir Agent, donner une tâche repo bornée, puis lire les diffs avant que rien ne reste.

2026-09-10

Le dépôt est déjà ouvert dans Cursor. Vous voulez que le modèle travaille — sans accepter une pile de diffs non lus. L’aide officielle appelle ce chemin le mode Agent : ouvrir un fil, donner une tâche repo, lire chaque fichier touché.

Le travail que l’on cherche est utiliser Cursor Agent : ouvrir le panneau Agent, éviter Ask en lecture seule, écrire une tâche bornée, décider dans la vue de diff ce qui reste. Raccourcis et relecture suivent cursor.com/help/ai-features/agent.

⌘IMac ouvre Agent ; Windows/Linux : Ctrl+I

4Modes : Agent, Ask, Plan, Debug

1Une tâche repo par nouveau fil

Choisir le mode autorisé à écrire

Agent écrit

Il parcourt l’arbre, modifie beaucoup de fichiers, lance un shell et peut s’arrêter pour corriger. Le résultat est un correctif que vous relisez, puis gardez.

Ask ne lit

Ask répond et n’édite pas. Si le panneau reste sur Ask, vous avez une explication et un diff vide. Maj+Tab cycle les modes ; le menu fait de même.

Mode	Quand	Modifie les fichiers ?
Agent	Fonction, refactor ou correctif que vous relirez	Oui
Ask	Comprendre seulement l’arbre	Non
Plan	Gros changement multi-fichiers, un plan d’abord	Après approbation du plan
Debug	Bug qui exige des preuves à l’exécution	Oui

Un passage : démarrer, assigner, relire

01
Ouvrir le panneau Agent
Dans un dossier déjà dépôt git, Cmd+I (Mac) ou Ctrl+I (Windows/Linux). Le sélecteur doit dire Agent. Si le fil précédent était une autre affaire, ouvrir un nouveau chat. L’aide : chaque mode a son contexte ; un fil neuf est plus propre quand la tâche change.
02
Donner une tâche repo bornée
Nommer le résultat, les fichiers ou la zone, et le critère de fin. Exemple : garde nulle dans src/auth/session.ts et lancer le test unitaire existant. Ne pas coller cinq corvées sans lien. L’exemple officiel est une demande concrète.
03
Regarder la vue de diff
Return. Agent explore, puis applique les éditions en travaillant. Les fichiers s’ouvrent dans le diff. Stop s’il quitte le dossier nommé. Un suivi attend en file jusqu’à la fin de la course.
04
Relire, puis garder ou refuser
Lire lignes ajoutées et supprimées. Refuser les morceaux indésirables. Survoler un message plus tôt et Restore Checkpoint pour ramener les fichiers après ce point — le fil reste. Lancer vos tests vous-même ; une ligne verte dans le journal n’est pas une recette.

Ajouter une garde dans src/auth/session.ts :
sans user id, renvoyer 401. Ne pas toucher
le dossier billing. Lancer le test unitaire
session existant et s’arrêter s’il échoue.

Où les premières tâches cassent

Le panneau était sur Ask: Aucun fichier ne change. Passer sur Agent avec Maj+Tab ou le sélecteur, renvoyer la même invite.
L’invite n’avait pas de borne: Agent cherche large. Nommer le répertoire, le test, et les chemins interdits.
Toute la pile acceptée: Refuser les fichiers de trop. Regarder les suppressions. Si la forme est fausse, restaurer un point de contrôle plutôt qu’empiler une seconde réécriture sur un mauvais correctif.

Une tâche, un fil, puis le diff. Le bouton accepter n’est pas une relecture.

Les Cloud Agents sont une autre porte

cursor.com/agents peut lancer un Cloud Agent depuis le navigateur. La boucle bureau de ce guide tient : la relecture est à vous. Ne fusionner de diffs non lus sur aucun des deux chemins.

S’il faut s’accorder sur un refactor avant de livrer, liste de fichiers et morceaux risqués sur une page. Une salle oakmeet courte suffit — navigateur, code d’espace, pas de compte. Limites dans huit personnes, environ une heure.

Agent est-il le même que Composer ou Chat ?

L’aide actuelle nomme Agent l’assistant qui peut éditer et lancer des commandes. L’ancienne interface disait Composer. Si votre build affiche encore Composer, choisir le mode autorisé à éditer, pas Ask/Chat en lecture seule.

Faut-il un compte et un forfait payant ?

Il faut être connecté. L’usage d’Agent suit votre forfait Cursor et les quotas de modèle. Les forfaits courants sont sur cursor.com/docs. Cette page n’en vend pas.

Peut-on annuler après avoir accepté un diff ?

Restore Checkpoint sur un message Agent plus tôt ramène les fichiers après ce point. git checkout / git restore restent valables pour ce qui est déjà sur le disque. La restauration n’efface pas le fil.

Faut-il commencer en Plan ?

Pour un gros changement multi-fichiers, la table dit Plan d’abord : vous approuvez l’approche, puis il peut éditer. Pour une tâche repo unique et bien bornée, ce tutoriel suit Agent.