Cursor

Cursor se connecte à votre espace de travail Pathrule via Pathrule CLI ou l'extension VS Code. Pathrule s'appuie sur les hooks natifs de Cursor et sur le serveur MCP local pour fournir les connaissances de l'espace de travail ciblées. Cursor dispose de hooks de session et d'outils, mais pas de hook de soumission de prompt : le contexte arrive donc au démarrage de la session et autour des appels d'outils, et non avec chaque prompt. Cursor utilise le serveur MCP local ; la configuration de Remote MCP n'est pas documentée pour Cursor.

Cette page décrit ce que Pathrule écrit dans votre projet pour Cursor, la correspondance des événements de hook entre clients et la manière de vérifier l'intégration.

Ce que Pathrule écrit

Lorsque vous installez Pathrule dans Cursor, vous obtenez :

• .cursor/hooks.json. La configuration de hooks native de Cursor. Pathrule y enregistre les événements qui l'intéressent et conserve les hooks que vous avez ajoutés vous-même.
• Une entrée de serveur MCP dans ~/.cursor/mcp.json. Votre configuration MCP Cursor au niveau utilisateur, pointée vers le serveur MCP Pathrule local. Vos autres serveurs restent tels quels.
• .cursor/rules/pathrule-protocol.mdc, ainsi que .cursorrules pour les anciennes versions de Cursor. Lorsque le hook est installé, ces fichiers ne contiennent qu'une courte note indiquant que Pathrule est actif et fourni par le hook.
• Des skills matérialisés dans .cursor/skills/<name>/SKILL.md, pour que Cursor puisse les invoquer par leur nom.

Lorsque le hook Cursor est installé, le protocole passe par sessionStart plutôt que par le fichier de règles, et les connaissances liées aux chemins arrivent par les hooks : aucun fichier de connaissances n'est donc écrit dans votre arborescence. Sans le hook, le fichier de règles contient le protocole complet et la vue d'ensemble de l'espace de travail, et Pathrule ajoute une règle .cursor/rules/pathrule-k-*.mdc limitée par un glob pour chaque répertoire auquel des connaissances sont rattachées.

Aucune option Skills tierce n'est nécessaire. Cursor voit directement le fournisseur de hooks Pathrule géré par le CLI.

Couverture des événements de hook

Les événements de Cursor correspondent aux points d'injection de Pathrule :

• sessionStart. Au début d'une nouvelle session. Pathrule renvoie les métadonnées de l'espace de travail, le protocole et le contexte de votre équipe, soit le même amorçage que celui reçu par Claude Code au démarrage de sa session.
• preToolUse. Avant que Cursor n'exécute un outil. C'est ici qu'une règle dotée d'un motif de blocage approuvé refuse une modification ou une écriture correspondante, en donnant la règle et la correction approuvée comme motif. Sur Cursor, cet événement ne transporte que la décision ; le contexte lié au chemin est fourni par sessionStart et postToolUse à la place.
• postToolUse. Une fois l'outil terminé. Pathrule l'utilise à la fois pour capturer l'activité et comme point de compensation pour le contexte lié au chemin que l'événement pré-outil de Cursor ne peut pas transporter.
• stop, subagentStop et sessionEnd. Clôturent le tour et la session.

L'événement par prompt de Cursor n'est volontairement pas enregistré : sa sortie ne peut pas transporter de contexte, et sessionStart associé à postToolUse couvre le même besoin.

Un unique script de hook partagé gère les différences de format d'événement entre Cursor et Claude Code. Vous n'avez pas à vous en soucier : installez Cursor via Pathrule et le bon format est mis en place.

Isolation par client

Pathrule prend en charge n'importe quelle combinaison de clients IA sur une même machine.

• Cursor uniquement. Pathrule n'écrit que les configurations Cursor.
• Claude Code uniquement. Pathrule n'écrit que les configurations Claude Code.
• Les deux. Pathrule écrit les deux. Les hooks s'enregistrent indépendamment, le serveur MCP est partagé et l'arborescence de contenu est la même.

Le choix correspond à ce que vous sélectionnez lorsque la configuration de Pathrule vous demande quels outils IA vous utilisez, dans pathrule setup ou dans l'extension VS Code.

Installation

Via Pathrule CLI :

pathrule setup

Lancez la commande dans le dossier du projet et choisissez Cursor lorsqu'elle vous demande quels outils IA vous utilisez. La configuration vous connecte à Pathrule Cloud si nécessaire, rattache le dossier à un espace de travail, installe l'entrée MCP, mémorise votre choix pour ce dossier et écrit les fichiers Cursor. Lancez plutôt pathrule setup --local pour utiliser Pathrule sans compte.

Pour assembler les éléments à la main dans un dossier déjà rattaché :

pathrule install cursor
pathrule sync
pathrule doctor

pathrule install cursor ajoute le serveur Pathrule à ~/.cursor/mcp.json sans toucher à vos autres serveurs. pathrule sync écrit les fichiers de projet pour les outils IA choisis pour ce dossier ou, si aucun n'a été choisi, pour ceux qu'il détecte dans le dossier.

Avec l'extension VS Code, qui fonctionne aussi dans Cursor, choisissez Cursor dans Connect AI Clients. L'extension écrit la même entrée MCP et la même configuration de hooks au moyen de son CLI intégré.

Vérification

Ouvrez Cursor dans un répertoire que vous avez rattaché à un espace de travail. Ouvrez l'onglet Hooks Settings pour vérifier que Pathrule apparaît comme fournisseur enregistré. Démarrez une nouvelle conversation. Le contexte lié au chemin doit apparaître avant le premier appel d'outil.

Si l'intégration reste muette :

pathrule doctor

Le doctor fonctionne en lecture seule. Il indique votre connexion, votre espace de travail et si ce dossier est rattaché, si l'entrée MCP Pathrule est installée pour Cursor et pour chaque autre client, ainsi que les fichiers gérés par Pathrule présents dans le dossier et qui les a écrits. Ajoutez --json pour obtenir le rapport complet, qui signale aussi une entrée MCP pointant vers un runtime qui n'existe plus. pathrule repair réécrit une entrée obsolète, resynchronise les fichiers de projet, y compris .cursor/hooks.json, puis relance le doctor.

Ce qui ne change pas

Tout ce que vous écrivez dans Pathrule arrive dans Cursor sous la même forme que dans Claude Code.

• Une mémoire écrite avec le CLI, l'extension VS Code ou via MCP apparaît dans les deux.
• Une règle dotée d'un motif de blocage approuvé bloque une modification correspondante dans les deux.
• Un skill peut être invoqué par son nom dans les deux.
• Les outils MCP (pathrule_get_context, pathrule_write_memory, etc.) se comportent de façon identique.

Si vous livrez une fonctionnalité pour un assistant, vous l'obtenez pour l'autre.

Pour aller plus loin

• Claude Code pour l'intégration sœur.
• Fonctionnement des hooks pour le modèle sous-jacent.
• Référence des outils MCP pour tous les outils que l'assistant peut appeler.