Windsurf

Windsurf se connecte à votre espace de travail Pathrule via Pathrule CLI ou l'extension VS Code. Pathrule écrit une entrée de serveur MCP local ainsi qu'un fichier de règles associé que Windsurf lit au démarrage de la session. Windsurf ne dispose pas de hooks : contrairement à Claude Code, Codex, Cursor et GitHub Copilot, il ne reçoit donc aucun contexte par ce biais. Le fichier de règles porte le protocole et la vue d'ensemble de l'espace de travail, et les outils MCP fournissent tout le reste en profondeur. Windsurf utilise le serveur MCP local ; la configuration Remote MCP n'est pas documentée pour Windsurf.

Cette page décrit ce que Pathrule écrit dans votre projet pour Windsurf, explique pourquoi Windsurf reçoit le même contenu que tous les autres outils, et montre comment vérifier vous-même l'intégration.

Ce que Pathrule écrit

Lorsque vous installez Pathrule dans Windsurf, vous obtenez :

• Une entrée de serveur MCP dans ~/.codeium/windsurf/mcp_config.json. Elle oriente l'assistant vers le serveur MCP Pathrule local pour qu'il puisse appeler les outils pathrule_*, sans toucher à vos autres serveurs.
• Un fichier d'instructions associé, .windsurf/rules/pathrule-protocol.md, accompagné de .windsurfrules pour les anciennes versions de Windsurf. Il contient la vue d'ensemble de l'espace de travail et le protocole Pathrule, c'est-à-dire le même fond que reçoivent les autres clients dans leurs propres formats natifs.
• Des fichiers de connaissances par chemin. Une règle .windsurf/rules/pathrule-k-*.md pour chaque répertoire auquel des connaissances sont rattachées, avec en en-tête le répertoire concerné.
• Des skills matérialisés dans .windsurf/skills/<name>/SKILL.md, pour que Windsurf puisse les invoquer par leur nom.

Windsurf n'ayant pas de hook Pathrule, ce sont ces fichiers qui lui transmettent le protocole et les connaissances au démarrage de la session. Sur les clients compatibles avec les hooks, Pathrule fournit désormais ce même protocole via le hook de démarrage de session et ne garde qu'une courte note dans le fichier d'instructions ; Windsurf conserve le fichier complet, car rien d'autre ne le lui transmettrait.

Le fichier associé n'est pas recopié à la main pour chaque client. Pathrule le génère à partir d'un moteur de rendu partagé qui produit aussi les instructions de Claude Code, Cursor et Codex : les quatre restent ainsi alignés au lieu de diverger avec le temps.

Comment le contenu parvient à Windsurf

Tout outil qui parle MCP peut utiliser Pathrule via stdio : il suffit d'ajouter la commande MCP Pathrule à la configuration du client pour que l'assistant voie les mêmes outils. Pour Windsurf, Pathrule CLI écrit cette configuration et génère le fichier associé à côté. Le fichier associé fournit la vue d'ensemble de l'espace de travail et le protocole au démarrage de la session ; les outils MCP fournissent le reste à la demande.

Deux principes permettent d'éviter toute divergence entre clients.

• Un seul contrat d'outils. Les outils MCP (pathrule_get_context, pathrule_read_memory, pathrule_write_memory, etc.) sont les mêmes que ceux qu'appellent Claude Code et Cursor. L'assistant récupère le contexte et écrit mémoires, règles et skills par la même interface ; seule la configuration du client change.
• Une seule source de vérité. Le fichier associé et les skills matérialisés sont des vues générées, pas la copie de référence. Une mémoire écrite avec le CLI, l'extension VS Code ou via MCP parvient à Windsurf sous la même forme qu'à tous les autres clients.

Pathrule n'envoie pas automatiquement le code source de votre dépôt. Les outils locaux d'apprentissage du projet peuvent examiner les fichiers rattachés à un constat pour le valider. Ce qui est stocké, ce sont les connaissances de votre équipe (mémoires, règles, skills), l'activité consignée par les agents, les constats qu'ils enregistrent avec les fichiers sur lesquels ils reposent et, sur un espace de travail Cloud, les paires de chemins de fichiers que Pathrule lit dans l'historique git récent pour repérer les fichiers qui changent ensemble. Consultez ce que Pathrule calcule pour savoir ce qui est envoyé et stocké en mode Cloud.

Une seule couche de contenu, plusieurs formats de diffusion

Chaque client lit un format d'instructions différent ; Pathrule produit donc tous les fichiers associés avec le même moteur de rendu partagé au lieu d'en recopier un à la main par outil. Le protocole Windsurf reste ainsi identique sur le fond aux versions Claude Code, Cursor et Codex, même si le format de fichier diffère.

L'effort porte sur la couche de contenu, pas sur le client. Les mêmes mémoires, règles et skills servent Windsurf et tous les autres clients sans rien réécrire.

Via l'extension VS Code

Windsurf est un fork de VS Code. Si vous utilisez l'extension Pathrule pour VS Code dans Windsurf, l'extension détecte l'hôte et écrit la même entrée MCP gérée grâce à l'installateur qu'utilise le CLI, sans aucun JSON à modifier à la main. Cette entrée pointe vers le runtime Pathrule embarqué et ne contient jamais de secrets.

Il s'agit simplement d'un point d'entrée supplémentaire vers le même espace de travail, pas d'une intégration distincte. Consultez Pathrule pour VS Code pour le fonctionnement de l'extension et MCP local et Remote MCP pour les différences entre stdio local et Remote MCP.

Isolation par client

Windsurf cohabite avec Claude Code, Cursor et Codex sur la même machine. Vous pouvez installer un client, plusieurs, ou tous.

• Ils partagent le même espace de travail Pathrule, le même serveur MCP et la même arborescence de contenu.
• Les configurations lues par chaque client sont indépendantes. Installer Windsurf ne touche pas aux autres.
• Supprimer un client laisse les autres, et le contenu, intacts.

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

Installation

Via Pathrule CLI :

pathrule setup

Lancez-la dans le dossier du projet et choisissez Windsurf lorsqu'elle vous demande quels outils d'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 Windsurf. Lancez plutôt pathrule setup --local pour utiliser Pathrule sans compte.

Pour tout brancher à la main dans un dossier déjà rattaché :

pathrule install windsurf
pathrule sync
pathrule doctor

pathrule install windsurf ajoute l'entrée MCP à ~/.codeium/windsurf/mcp_config.json. pathrule sync génère les fichiers du projet pour les outils d'IA choisis pour ce dossier ou, si aucun n'a été choisi, pour ceux qu'il détecte dans le dossier.

Vous pouvez aussi utiliser l'extension VS Code dans Windsurf, comme décrit plus haut.

Vérification

Ouvrez Windsurf dans un répertoire rattaché à un espace de travail. L'assistant doit lire le fichier associé au démarrage de la session et pouvoir appeler pathrule_get_context sur votre répertoire de travail.

Lancez un prompt qui concerne un chemin doté de contenu. L'assistant doit faire remonter ce contenu via les outils MCP. Si ce n'est pas le cas :

pathrule doctor

Le doctor fonctionne en lecture seule. Il indique votre connexion, votre espace de travail et si ce dossier y est rattaché, si l'entrée MCP Pathrule est installée pour Windsurf et pour chacun des autres clients, ainsi que les fichiers gérés par Pathrule présents dans le dossier et leur auteur. 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, régénère les fichiers associés et relance le doctor.

Ce qui ne change pas

La couche de contenu est identique d'un client à l'autre.

• La mémoire que Claude Code reçoit via le hook, Windsurf la reçoit via les outils MCP.
• Une règle parvient à Windsurf par le fichier associé et par MCP. Windsurf n'ayant pas de hooks, une règle ne peut pas y bloquer une modification ; le blocage avant écriture n'existe que sur les clients dotés de hooks d'outils : Claude Code, Codex, Cursor et GitHub Copilot.
• Un skill peut être invoqué par son nom.
• Les outils MCP se comportent de la même manière.

Si votre équipe écrit du contenu pour un assistant, tous les assistants en bénéficient.

Pour aller plus loin

• Cursor pour l'intégration sœur, elle aussi fork de VS Code, avec hooks natifs.
• MCP local et Remote MCP pour comprendre pourquoi les outils exposés sont partout les mêmes.
• Pathrule pour VS Code pour l'extension capable d'enregistrer Windsurf depuis l'éditeur.
• Fonctionnement des hooks pour le modèle de diffusion sur lequel repose le contenu.