Aller au contenu
Pathrule

documentation

Pathrule pour VS Code

L'interface éditeur de Pathrule pour VS Code et ses forks, avec une arborescence de connaissances, l'édition dans des onglets Markdown, un mode local sans compte et la configuration des agents en une seule commande.

Sur cette page

Pathrule pour VS Code est une interface native de l'éditeur. Elle intègre à l'éditeur l'arborescence de connaissances de l'espace de travail, l'édition du contenu et la configuration des clients IA : le dossier ouvert correspond à l'espace de travail, et le fichier que vous modifiez correspond au chemin. C'est l'interface qu'il vous faut si vous passez vos journées dans VS Code, Cursor ou Windsurf et que vous voulez vos connaissances à côté de votre code.

Il s'agit d'une interface éditeur ciblée. Le contenu et les hooks que manipule le CLI sont pilotés depuis l'éditeur que vous utilisez déjà, et la configuration des clients externes réutilise l'installateur du CLI.

Installation

Installez l'extension depuis le Visual Studio Marketplace, ou depuis Open VSX pour pouvoir aussi l'installer dans Cursor et Windsurf. Depuis un terminal :

code --install-extension Pathrule.pathrule-vscode

Ou bien, depuis l'éditeur, ouvrez l'invite Quick Open et exécutez :

ext install Pathrule.pathrule-vscode

L'extension est gratuite et open source sous licence Apache-2.0, et le mode local ne demande aucun compte : vous pouvez commencer dès la fin de l'installation.

Ce que gère l'extension

  • Arborescence de connaissances. Une barre latérale qui n'affiche que les chemins porteurs de connaissances, selon la structure du dépôt, avec les mémoires, règles et skills regroupés sous chaque chemin. Le nombre d'éléments de contenu apparaît sous forme de badges sur les lignes de l'arborescence et sur les fichiers et dossiers correspondants dans l'explorateur intégré.
  • Synchronisation avec le fichier actif. Lorsque vous passez d'un fichier à l'autre, l'arborescence suit l'éditeur jusqu'au chemin le plus profond qui couvre le fichier courant, et la barre d'état affiche ce chemin avec le nombre d'éléments de contenu associés.
  • Édition du contenu. Les mémoires, règles et skills s'ouvrent comme des onglets Markdown ordinaires. L'enregistrement passe par Pathrule, et vous profitez gratuitement de tous les outils de l'éditeur.
  • Configuration des agents. Une seule commande connecte vos clients IA et installe les hooks liés aux chemins, soit la même configuration que celle effectuée par le CLI.
  • Prise en main. Ouvrez un dossier qui n'a pas encore d'espace de travail, et l'extension vous guide de la configuration jusqu'à un espace de travail associé, sans quitter l'éditeur.
  • Doctor. Une seule commande vérifie que chaque client est connecté, que les hooks sont présents et que le serveur de contexte est joignable.

Mode local et mode Cloud

L'extension fonctionne selon deux modes derrière une même interface utilisateur, avec la même répartition que le CLI et le cœur open source.

  • Le mode local ne demande aucun compte. Initialisez un dossier en local, et vos mémoires, règles et skills restent sur votre machine. C'est la façon la plus rapide de commencer.
  • Le mode Cloud vous connecte et ajoute la couche équipe : connaissances partagées, activité de l'équipe et backend géré.

Le mode est une propriété du dossier ouvert, pas une supposition. Un utilisateur connecté dont le dossier n'est pas encore un espace de travail Cloud se voit proposer deux options : en créer un dans l'organisation courante, ou initialiser le dossier en local. Lorsqu'un dossier est en mode local, les actions propres au cloud sont masquées plutôt que cassées, si bien qu'une même extension couvre les deux cas.

Édition dans des onglets Markdown

Ouvrez une mémoire, une règle ou un skill depuis l'arborescence : l'élément s'ouvre dans un onglet Markdown normal. Modifiez-le comme n'importe quel fichier, puis enregistrez pour conserver la modification. Si un collègue a modifié le même élément pendant que vous l'aviez ouvert, l'enregistrement n'écrase pas son travail en silence : vous pouvez recharger, garder une copie de votre version ou écraser avec la vôtre. Les conflits se présentent comme une décision à prendre, jamais comme des modifications perdues.

Depuis l'explorateur, faites un clic droit sur n'importe quel fichier ou dossier pour accéder à un sous-menu Pathrule : parcourez les connaissances qui s'y appliquent, ou créez une nouvelle mémoire, règle ou un nouveau skill lié à ce chemin. Depuis un élément de l'arborescence, vous pouvez le copier comme pointeur de prompt, afficher ses détails, le renommer, le déplacer vers un autre chemin ou le supprimer avec possibilité d'annuler. La sélection multiple permet de déplacer et de supprimer en masse, et une recherche approximative porte sur tous les titres de l'espace de travail.

Identité partagée avec le CLI

La connexion depuis l'extension utilise la même page de connexion hébergée que le CLI, au choix avec GitHub, Google ou une adresse e-mail. La session est partagée : vous connecter ici connecte aussi le CLI, et changer d'organisation dans l'un la change dans l'autre. Une seule identité pour l'extension, le CLI et votre assistant IA.

Connecter vos clients IA

Une seule commande, Connect AI clients, relie votre assistant à Pathrule sans aucune modification de JSON.

  • Pour le mode agent de GitHub Copilot, l'extension enregistre le serveur MCP de Pathrule pour le dossier associé.
  • Claude Code, Codex, Cursor et Windsurf reçoivent des entrées MCP gérées, écrites avec le même installateur que celui du CLI.
  • Les hooks sont installés via le même pipeline que celui du CLI, et la notification de résultat indique précisément ce qui a été écrit.

Votre assistant reçoit ensuite le contexte Pathrule du chemin courant par le canal qu'il prend en charge : des hooks comprenant un hook de prompt pour Claude Code et Codex, des hooks de session et d'outil pour Cursor et GitHub Copilot, et un fichier de règles associé à MCP pour Windsurf, qui n'a pas de hooks. Lancez la commande doctor à tout moment pour vérifier que chaque client est connecté et que les hooks sont à jour.

Travailler avec votre équipe

Les écritures dans le cloud sont partagées, mais le backend Cloud actuel ne propose pas d'abonnement en temps réel. Actualisez la vue des connaissances ou redemandez le contexte pour lire l'état le plus récent ; les hooks locaux et les fichiers d'instructions utilisent les connaissances préparées jusqu'à leur actualisation. Le travail au niveau de l'organisation reste dans Pathrule Web : la gestion de l'équipe, les offres et la facturation, ainsi que la vue d'ensemble de tous les espaces de travail, sont accessibles par des liens plutôt que réimplémentées dans l'éditeur.

Si vous avez commencé en mode local et souhaitez partager un dossier avec votre équipe, une seule action vous connecte, vous fait choisir une organisation et copie l'espace de travail et son contenu dans le cloud, en conservant votre copie locale comme solution de repli.

Quand utiliser Pathrule pour VS Code

Utilisez l'extension si vous travaillez principalement dans VS Code, Cursor ou Windsurf et que vous voulez l'arborescence de connaissances de l'espace de travail, l'édition du contenu et la configuration des agents dans l'éditeur, qui connaît déjà votre dossier ouvert et votre fichier actif. Commencez en mode local en quelques secondes, et connectez-vous plus tard lorsque vous aurez besoin de la couche équipe.

Si vous passez vos journées dans le terminal ou que vous intégrez Pathrule à vos scripts de CI, préférez Pathrule CLI. Les deux partagent la même connexion, vous pouvez donc utiliser l'un et l'autre.

  • Pathrule CLI, l'environnement d'exécution centré sur le terminal, qui partage la même identité et les mêmes hooks.
  • Cœur open source, pour savoir ce que fait tourner le mode local et ce qu'apporte Cloud.
  • Fonctionnement des hooks, pour savoir ce que l'extension transmet à votre assistant.