Aide-mémoire Cursor (2026) : Agent, Ask, rules, MCP et raccourcis

Modes, fichiers de règles, config MCP et raccourcis pour l’éditeur Cursor. Le panneau Agent est la surface de chat : il recherche le repo, édite les fichiers et exécute le terminal. Une comparaison avec deux autres agents de codage se trouve dans Claude Code vs Copilot vs Cursor.

Modes

Ouvrez le panneau avec Cmd+I (macOS) ou Ctrl+I (Windows et Linux). Shift+Tab bascule les modes. Cmd+. ou Ctrl+. ouvre le menu des modes. Un basculement démarre une nouvelle fenêtre de contexte. Le mode agent de Copilot est un produit différent.

Plan sauvegarde le plan dans votre répertoire personnel. Enregistrer sur le workspace le déplace dans le projet. Voir développement piloté par spécification. Pendant que Agent fonctionne, Entrée met en file d’attente la prochaine note. Sur macOS, Cmd+Entrée l’envoie maintenant. Restore Checkpoint annule les fichiers et garde la transcription.

Tab et l’ancien raccourci d’édition en ligne

Tab complète à partir des éditions récentes, du code à proximité et des erreurs du linter, affichées en texte gris. Il peut changer plusieurs lignes, ajouter un import ou sauter vers un autre fichier (un portail apparaît en bas de l’éditeur). Tab à nouveau, après une acceptation, se déplace vers la prochaine édition prédite. Les règles n’affectent pas Tab. Snooze ou désactivez-le à partir de l’indicateur Tab en bas à droite.

La page d’aide d’édition en ligne ancienne décrit maintenant Agent. Avec du code sélectionné, Cmd+K ou Ctrl+K ouvre Agent avec ces lignes. Cmd+L et Ctrl+L font la même chose. La doc dit que Cmd+K ouvrait autrefois l’édition en ligne et que cela a été remplacé. Les mêmes touches basculent le panneau latéral quand elles ne sont pas liées à un mode. Dans la fenêtre Agents, Cmd+K ou Ctrl+K ouvre la palette de commandes pour les transcriptions passées. Cmd+F ou Ctrl+F recherche dans la conversation ouverte.

Mentions @

Tapez @ et continuez à taper pour filtrer. Ignorez-le si vous ne connaissez pas le fichier. Agent recherchera. Répétez @ pour attacher plus d’un élément. / exécute une compétence pour un seul message. Option+Entrée (macOS) ou Alt+Entrée (Windows) garde cette compétence comme un mode personnalisé.

Agent peut rechercher le web avec son outil Web. Ce n’est pas une mention @. La doc de mention actuelle ne liste pas @Docs ou @Web.

Règles et AGENTS.md

Les règles sont des instructions au début du contexte du modèle. Les règles de projet, utilisateur et équipe s’appliquent dans Agent, Ask, Plan et Debug. Elles ne s’appliquent pas à Tab, et .cursor/rules n’est pas ce que Bugbot lit.

Les règles de projet sont des fichiers .mdc dans .cursor/rules, y compris les sous-dossiers. Un fichier .md là est ignoré. Validez le dossier. Créez-en un avec New Cursor Rule dans la palette de commandes (Cmd+Shift+P ou Ctrl+Shift+P), depuis Customize, ou avec /create-rule.

Séparez les globs par des virgules. Gardez une règle sous 500 lignes. Un chemin tel que @service-template.ts pointe Agent vers un fichier. Le fichier n’est pas en ligne, donc tout ce qui doit toujours être présent va dans le corps de la règle.

---
description: Comment ce repo exécute les tests
alwaysApply: false
---

- Exécutez les tests avec `npm test` à partir de la racine du repository
- N'éditez rien sous `dist/` ou `build/`

AGENTS.md est du Markdown ordinaire, à la racine ou dans un sous-dossier. Les fichiers imbriqués s’appliquent sous ce répertoire, se combinent avec les parents, et le fichier plus proche gagne. Cursor lit CLAUDE.md de la même façon et l’applique toujours, en ignorant alwaysApply. Cela chevauche Claude Code.

Les règles utilisateur dans Customize, Rules, se synchronisent avec votre compte. Les fichiers dans ~/.cursor/rules (sur Windows, %USERPROFILE%\.cursor\rules) restent sur cette machine. Les Team Rules viennent du tableau de bord sur les plans Team et Enterprise. En cas de conflit, l’ordre est Team, puis Project, puis User.

.cursorrules à la racine du projet est hérité et sera déprécié. Collez-le dans une règle Always Apply et supprimez l’ancien fichier.

MCP

MCP connecte Agent aux outils externes. La configuration qui n’est pas spécifique à Cursor est dans Serveurs MCP expliqués. Cursor supporte stdio local, SSE et HTTP streamable. Agent appelle un outil quand il est pertinent, y compris en mode Plan, et demande d’abord sauf si Run Mode permet l’appel. Basculez les serveurs dans Customize. Les journaux se trouvent sous MCP Logs dans le panneau Output (Cmd+Shift+U sur macOS).

Une entrée locale définit command, args et env. Une entrée distante définit url et headers optionnels. Seul stdio accepte envFile. Les valeurs peuvent utiliser ${env:NAME} et ${workspaceFolder}. La CLI lit le même fichier. Les boucles d’outils sont le motif dans IA agentic.

{
  "mcpServers": {
    "repo-tools": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

Cloud Agents et Bugbot

Les Cloud Agents s’appelaient autrefois Background Agents. Ils s’exécutent dans une VM isolée et peuvent ouvrir une pull request. Commencez à partir de Cloud sous l’entrée d’agent, depuis cursor.com/agents, ou avec @cursor dans Slack, Linear, GitHub ou Bitbucket. Dans la CLI, préfixez le message avec &. À partir d’octobre 2026, la doc nécessite Premium ou supérieur, Teams, Enterprise, ou un plan payant hérité. Free et Plus ne les incluent pas. Tab ne s’exécute pas dans le cloud.

Bugbot commente les diffs de pull request, à chaque mise à jour ou après cursor review ou bugbot run. Un compte bot ou une GitHub App les postant est ignoré. .cursor/rules ne s’applique pas. Mettez les notes de révision dans .cursor/BUGBOT.md. Le fichier root est toujours inclus. Un fichier imbriqué s’applique quand les chemins modifiés siègent en dessous. Les paramètres optionnels vivent dans .cursor/config/bugbot.yaml sur la branche de base.

/review et /review-bugbot, dans Cursor 3.7+, sur cursor.com/agents et dans la CLI, révisent la diff de branche contre la base par défaut, y compris les édits non-validés.

CLI

La commande documentée est agent.

agent --version et agent update vérifient et mettent à jour la CLI. Sur macOS, Linux ou WSL, ajoutez ~/.local/bin à PATH si agent manque. /summarize réduit le contexte (/compress est un alias). Ctrl+J insère une nouvelle ligne. Ctrl+D quitte au second appui. La CLI charge .cursor/rules plus le root AGENTS.md et CLAUDE.md. Debug est éditeur-only.

Modèles et Mode Privé

Cmd+/ ou Ctrl+/ bascule les modèles. Sur macOS, Cmd+Option+/ bascule le modèle. Le choix persiste jusqu’à ce que vous le changiez. Auto utilise Cursor Router et peut changer de modèle entre les tours.

À partir d’octobre 2026, Free et Plus incluent Grok 4.7, Grok 4.6, Grok 4.5 et Composer 2.5. Premium et supérieur, Teams, Enterprise et legacy Pro, Pro+ et Ultra déverrouillent les modèles tiers.

Mode privé maintient le code hors de l’entraînement par Cursor et par les fournisseurs de modèles. Activez-le sous General dans les paramètres (Cmd+Shift+J ou Ctrl+Shift+J). Les équipes Enterprise l’ont activé par défaut, et un administrateur peut le verrouiller. Vos propres clés API suivent la politique du fournisseur. Les modèles qui nécessitent la rétention des données par le fournisseur restent désactivés jusqu’à ce qu’un administrateur les approuve.

Raccourcis clavier

Ouvrez la carte complète avec Cmd+R puis Cmd+S, ou Ctrl+R puis Ctrl+S. Les accords Windows ci-dessous sont seulement ceux qu’une page d’aide énonce.

Motifs que vous réutiliserez

Shift+Tab vers Ask quand la réponse ne doit pas toucher les fichiers
Shift+Tab vers Plan, éditez le plan, puis construisez
Sélectionnez le test échoué, appuyez sur Ctrl+L, et nommez le correctif
Tab accepte, Escape saute, Ctrl+Right prend un mot
Mettez les instructions répétées dans .cursor/rules/*.mdc et les tokens dans ${env:API_KEY}
agent --mode=ask -p "list failing tests and their files"
Préfixez & quand la course devrait continuer après que l'ordinateur portable se ferme

Nommez le fichier et ce qu’être fait signifie. Le même haut se trouve dans la feuille de triche ChatGPT prompting. Un test échoué avant l’édition est la boucle dans TDD assisté par IA.

FAQ

Chat est-il un mode séparé d’Agent dans Cursor ?

La doc actuelle décrit un seul panneau Agent, aussi appelé Agent Chat, et quatre modes à l’intérieur : Agent, Ask, Plan et Debug. Il n’y a pas de mode Chat séparé dans cette liste. Ouvrez le panneau avec Cmd+I ou Ctrl+I, puis basculez avec Shift+Tab ou le sélecteur de mode. Basculer de mode démarre une nouvelle fenêtre de contexte.

Où vivent les règles de projet Cursor, et que faire avec .cursorrules ?

Les règles de projet sont des fichiers .mdc dans .cursor/rules. Un fichier .md ordinaire dans ce dossier est ignoré. Les règles utilisateur vivent dans Customize, Rules, et se synchronisent avec votre compte ; les fichiers sous ~/.cursor/rules restent sur cette machine. .cursorrules à la racine du repo est hérité. Copiez-le dans une règle Always Apply, puis supprimez l’ancien fichier.

Que fait Cmd+K ou Ctrl+K dans Cursor maintenant ?

Avec du code sélectionné, Cmd+K ou Ctrl+K ouvre Agent avec ces lignes en entrée. Cmd+L et Ctrl+L font la même chose. Les docs d’aide disent que Cmd+K ouvrait autrefois l’édition en ligne et que ce workflow a été remplacé. Les mêmes touches basculent aussi le panneau latéral quand elles ne sont pas liées à un mode.

Comment ajouter un serveur MCP dans Cursor ?

Mettez un serveur repo dans .cursor/mcp.json ou un serveur personnel dans ~/.cursor/mcp.json. Un serveur local définit command, args et env. Un serveur distant définit url et headers optionnels. La CLI lit le même mcp.json. Activez ou désactivez les serveurs à partir de Customize.

Comment exécuter Cursor Agent depuis le terminal ?

Installez le script officiel, puis exécutez agent. Shift+Tab tourne Agent, Plan et Ask. /plan et /ask basculent les modes, et agent -p exécute un prompt et quitte. Préfixez un message avec & pour remettre cette tâche à un Cloud Agent et la récupérer sur cursor.com/agents.