Aller au contenu
Pathrule

pathrule.iodocs

Pathrule

documentation

DocumentationCommencer

Démarrage rapide

Installez Pathrule CLI, choisissez Cloud ou Local, connectez un espace de travail et vérifiez que les connaissances ciblées parviennent à votre agent de codage.

Sur cette page

Partez d'un dépôt local et de l'agent que vous utilisez déjà. Le CLI est le point d'installation de Pathrule et son interface en terminal. Il connecte les agents compatibles sous macOS, Linux ou Windows, et les mêmes connaissances de l'espace de travail sont accessibles depuis l'extension VS Code et via MCP. Le modèle optionnel exécuté sur l'appareil a ses propres exigences de plateforme.

Pour explorer d'abord un petit projet local, suivez Exemple d'espace de travail. C'est vous qui le créez et le modifiez.

1. Installer un runtime

Installez le CLI avec Node.js 20.11.1 ou une version plus récente :

npm i -g @pathrule/cli
  • Le CLI exécute Pathrule dans le terminal, via SSH et dans vos automatisations. Consultez Installation du CLI pour le détail des prérequis.
  • L'extension VS Code permet de parcourir et de modifier les connaissances dans l'éditeur, et peut elle aussi connecter vos clients IA. Consultez Pathrule pour VS Code.

Vous pouvez utiliser les deux avec les mêmes connaissances d'espace de travail. En mode Cloud, ils sont reliés par votre compte. L'utilisation locale du CLI ne demande aucun compte.

2. Se connecter

pathrule setup vous demande de choisir Cloud ou Local. Cloud vous connecte pour partager les connaissances de l'espace de travail. Local ne demande aucun compte. Utilisez pathrule setup --local pour choisir Local directement et passer la connexion. Local ou Cloud compare les deux options. Passez à l'étape 3 pour lancer la configuration.

En mode Cloud, vous pouvez aussi vous connecter séparément avec un code à usage unique, sur un poste de travail, via SSH ou sur une machine sans interface graphique :

pathrule login

Le CLI affiche le code et ouvre la page d'approbation avec le code déjà renseigné. Si la machine n'a pas de navigateur, ouvrez l'URL affichée sur n'importe quel appareil, saisissez le code et approuvez. Pour utiliser plutôt le flux de rappel navigateur sur cette machine, exécutez pathrule login --browser-callback.

Dans les deux cas, vous êtes ensuite connecté, avec une session que le runtime renouvelle en arrière-plan.

3. Créer un espace de travail

L'espace de travail est l'unité à laquelle Pathrule rattache le contenu. Il correspond à un dépôt ou à un petit groupe de dépôts sur votre machine.

Avec le CLI, tout se passe dans le dossier où vous l'exécutez : placez-vous donc d'abord dans le dépôt. Le parcours guidé crée ou rattache l'espace de travail et connecte vos clients IA en une seule fois :

cd ~/repos/my-team
pathrule setup

La configuration affiche votre organisation, suggère les espaces de travail correspondants ou en crée un pour ce dossier, puis vous demande quels clients IA compatibles connecter. Elle peut ensuite proposer une première analyse du projet, menée par votre agent, qui suggère des mémoires, des règles et des skills à approuver. Pour un espace de travail conservé sur cette machine sans compte, exécutez pathrule setup --local ; consultez la configuration locale.

Pour une configuration Cloud manuelle, pathrule init crée un espace de travail portant le nom du dossier et y rattache le dossier. Pour rattacher un espace de travail Cloud existant, indiquez son nom ou son identifiant :

cd ~/repos/my-team
pathrule workspace attach my-team

Aucune option ne permet de passer un chemin : le CLI rattache toujours le dossier courant. Connectez ensuite vos clients avec pathrule install <client> et pathrule sync, comme l'explique Installation du CLI. Le runtime s'appuie sur cette correspondance pour associer votre répertoire courant à un espace de travail.

4. Rédiger votre première mémoire

Le moyen le plus rapide de vérifier que tout est bien branché consiste à rédiger une mémoire, puis à ouvrir votre assistant dans la portée qu'elle couvre. Pour ce guide, placez-la à la racine de l'espace de travail.

Title: Our database is Postgres on Supabase
Body:
- All queries should treat row level security as the source of truth.
- Do not bypass RLS with a service key in user facing code.
- Migrations live in supabase/migrations and run through CI.

Depuis le terminal, sur un espace de travail Cloud, une seule commande suffit. Sans --body, le CLI ouvre votre éditeur (VISUAL ou EDITOR) pour saisir le corps ; vous pouvez aussi passer --body ou envoyer le texte par un pipe.

pathrule memory add --path / --title "Our database is Postgres on Supabase"

Exécutez ensuite pathrule sync dans le dépôt pour que les fichiers et l'index local lus par vos clients prennent en compte la nouvelle mémoire.

Dans VS Code, utilisez New Memory… dans la vue Pathrule. Sur un espace de travail local, rédigez-la dans la Local Console ou demandez à votre agent de l'enregistrer via les outils MCP de Pathrule. Le CLI liste, lit et recherche les connaissances locales, mais ne permet pas d'en ajouter.

5. Observer le déclenchement du hook

Ouvrez Claude Code ou Codex dans le répertoire que vous avez rattaché à l'espace de travail. Lancez un nouveau tour et posez une question qui touche au domaine couvert par la mémoire.

Lorsque vous envoyez le prompt, le hook Pathrule lit la tranche en cache pour ce chemin, met en forme les mémoires et règles pertinentes, puis les transmet à l'agent avant son premier appel d'outil. La mémoire apparaît dans la zone de contexte que votre agent expose, sans aller-retour supplémentaire en cours de tâche.

Cursor et GitHub Copilot n'ont pas de hook de prompt : Pathrule les atteint par des hooks de session et d'outil, leurs fichiers d'instructions et MCP. Windsurf n'a pas de hooks : il utilise son fichier de règles pour l'amorçage de session et MCP pour un contexte plus approfondi. Vérifiez donc ces clients à l'aide de leurs guides : Cursor, GitHub Copilot et Windsurf.

Si rien n'apparaît, lancez le diagnostic.

pathrule doctor

Le diagnostic vérifie votre connexion, l'espace de travail et le rattachement de ce dossier, l'entrée MCP de chaque client IA ainsi que les fichiers gérés par Pathrule dans le dossier, et indique la commande à exécuter pour chaque point qui demande votre attention. Une entrée client obsolète se corrige avec pathrule repair.

6. Ajouter une règle

Les mémoires sont des faits. Les règles sont des contraintes. Ajoutez une règle sur le même chemin. Sur un espace de travail Cloud, depuis le terminal :

pathrule rule add --path / --name "No service key in browser code" --priority high --scope folder \
  --body "Never use the SUPABASE_SERVICE_ROLE_KEY in any file under apps/web. Use the anon key plus row level security."

Vous pouvez aussi utiliser New Rule… dans l'extension VS Code, ou demander à votre agent d'enregistrer la règle.

Rouvrez Claude Code. La règle arrive avec la mémoire. La priorité high la place près du sommet. Livrée comme contexte, une règle est une exigence que l'agent est invité à respecter, pas un blocage. Une règle peut aussi porter une contrainte exécutable : un agent peut en proposer une, elle est enregistrée comme proposition et n'est pas appliquée, et ce n'est qu'après approbation par une personne que le hook pré-outil peut bloquer une modification correspondante, dans les clients dont les hooks d'outil respectent cette décision. Consultez Les règles comme garde-fous.

Pour aller plus loin