Zum Inhalt springen
Pathrule

doku

Pathrule für VS Code

Die Pathrule-Editoroberfläche für VS Code und seine Forks, mit Wissensbaum, Bearbeitung in Markdown-Tabs, lokalem Modus ohne Konto und Agent-Einrichtung per Befehl.

Auf dieser Seite

Pathrule für VS Code ist eine native Editoroberfläche. Sie holt den Wissensbaum des Workspace, die Inhaltsbearbeitung und die Einrichtung der KI-Clients direkt in den Editor: Der geöffnete Ordner ist der Workspace, die Datei, die du gerade bearbeitest, ist der Pfad. Das ist die richtige Oberfläche, wenn du in VS Code, Cursor oder Windsurf zu Hause bist und dein Wissen direkt neben deinem Code haben willst.

Es ist eine fokussierte Editoroberfläche. Dieselben Inhalte und Hooks, mit denen die CLI arbeitet, steuerst du aus dem Editor, den du ohnehin nutzt, und für die Einrichtung externer Clients wird der Installer der CLI wiederverwendet.

Installation

Installiere die Erweiterung aus dem Visual Studio Marketplace oder von Open VSX, damit auch Cursor und Windsurf sie installieren können. Im Terminal:

code --install-extension Pathrule.pathrule-vscode

Oder öffne im Editor die Quick-Open-Eingabe und führe Folgendes aus:

ext install Pathrule.pathrule-vscode

Die Erweiterung ist kostenlos und Open Source unter Apache-2.0, und der lokale Modus braucht kein Konto. Du kannst also direkt nach der Installation loslegen.

Was die Erweiterung übernimmt

  • Wissensbaum. Eine Seitenleiste, die nur die Pfade zeigt, an denen Wissen hängt, aufgebaut wie das Repository, mit Memories, Regeln und Skills unter dem jeweiligen Pfad gruppiert. Die Anzahl der Inhalte erscheint als Badge an den Einträgen im Baum und an den entsprechenden Dateien und Ordnern im eingebauten Explorer.
  • Synchronisierung mit der aktiven Datei. Wenn du zwischen Dateien wechselst, folgt der Baum dem Editor bis zum tiefsten Pfad, der die aktuelle Datei abdeckt, und die Statusleiste zeigt diesen Pfad mit der Anzahl seiner Inhalte.
  • Inhaltsbearbeitung. Memories, Regeln und Skills öffnen sich als gewöhnliche Markdown-Editor-Tabs. Gespeichert wird über Pathrule, und die gesamte Editor-Ausstattung bekommst du gratis dazu.
  • Agent-Einrichtung. Ein Befehl verbindet deine KI-Clients und installiert die pfadbezogenen Hooks, genau die Einrichtung, die auch die CLI vornimmt.
  • Onboarding. Öffnest du einen Ordner, für den es noch keinen Workspace gibt, führt dich die Erweiterung von der Einrichtung bis zum verknüpften Workspace, ohne dass du den Editor verlässt.
  • Doctor. Ein einzelner Befehl, der prüft, ob jeder Client verbunden ist, die Hooks vorhanden sind und der Kontextserver erreichbar ist.

Lokaler Modus und Cloud-Modus

Die Erweiterung läuft in zwei Modi hinter einer einzigen Oberfläche, mit derselben Aufteilung wie die CLI und der Open-Source-Kern.

  • Lokaler Modus braucht kein Konto. Initialisiere einen Ordner lokal, und deine Memories, Regeln und Skills liegen auf deinem Rechner. So legst du am schnellsten los.
  • Cloud-Modus meldet dich an und ergänzt die Team-Ebene: geteiltes Wissen, Team-Aktivität und das verwaltete Backend.

Der Modus ist eine Eigenschaft des geöffneten Ordners, keine Vermutung. Wer angemeldet ist und einen Ordner öffnet, der noch kein Cloud-Workspace ist, bekommt beide Optionen angeboten: einen Workspace in der aktuellen Organisation anlegen oder lokal initialisieren. Ist ein Ordner im lokalen Modus, werden reine Cloud-Aktionen ausgeblendet statt in einen Fehler zu laufen. So deckt dieselbe Erweiterung beide Fälle ab.

Bearbeiten in Markdown-Tabs

Öffnest du eine Memory, eine Regel oder einen Skill aus dem Baum, erscheint der Inhalt als normaler Markdown-Tab. Bearbeite ihn wie jede andere Datei und speichere, um die Änderung zu übernehmen. Hat jemand aus deinem Team denselben Eintrag geändert, während du ihn offen hattest, überschreibt das Speichern diese Arbeit nicht stillschweigend: Du kannst neu laden, eine Kopie deiner Version behalten oder mit deiner Version überschreiben. Konflikte landen als Entscheidung bei dir, nie als verlorene Änderungen.

Im Explorer öffnest du per Rechtsklick auf eine Datei oder einen Ordner ein Pathrule-Untermenü: Dort durchsuchst du das Wissen, das an dieser Stelle gilt, oder legst eine neue Memory, eine neue Regel oder einen neuen Skill für genau diesen Pfad an. Über einen Eintrag im Baum kannst du ihn als Prompt-Verweis kopieren, seine Details ansehen, ihn umbenennen, an einen anderen Pfad verschieben oder ihn mit Rückgängig-Option löschen. Mit Mehrfachauswahl verschiebst und löschst du mehrere Einträge auf einmal, und eine unscharfe Suche durchsucht alle Titel im gesamten Workspace.

Gemeinsame Identität mit der CLI

Die Anmeldung aus der Erweiterung nutzt denselben gehosteten Login wie die CLI, wahlweise über GitHub, Google oder E-Mail. Die Session ist gemeinsam: Meldest du dich hier an, ist auch die CLI angemeldet, und wechselst du in einem der beiden die Organisation, wechselt sie auch im anderen. Eine Identität für die Erweiterung, die CLI und deinen KI-Assistenten.

KI-Clients verbinden

Ein einziger Befehl, Connect AI clients, bindet deinen Assistenten an Pathrule an, ganz ohne JSON-Bearbeitung.

  • Der Agent-Modus von GitHub Copilot bekommt den MCP-Server von Pathrule von der Erweiterung für den verknüpften Ordner registriert.
  • Claude Code, Codex, Cursor und Windsurf erhalten verwaltete MCP-Einträge, geschrieben mit demselben Installer, den auch die CLI verwendet.
  • Hooks werden über dieselbe Pipeline installiert, die auch die CLI nutzt, und die Ergebnismeldung listet genau auf, was geschrieben wurde.

Danach erhält dein Assistent den Pathrule-Kontext für den aktuellen Pfad über den Kanal, den er unterstützt: Hooks inklusive Prompt-Hook bei Claude Code und Codex, Session- und Tool-Hooks bei Cursor und GitHub Copilot, und bei Windsurf, das keine Hooks kennt, eine Regeldatei plus MCP. Mit dem Doctor-Befehl prüfst du jederzeit, ob jeder Client verbunden ist und die Hooks aktuell sind.

Arbeiten im Team

Schreibvorgänge in der Cloud werden geteilt, das aktuelle Cloud-Backend bietet aber kein Echtzeit-Abonnement. Aktualisiere die Wissensansicht oder fordere den Kontext erneut an, um den neuesten Stand zu lesen; lokale Hooks und Anweisungsdateien verwenden bis zur Aktualisierung das vorbereitete Wissen. Arbeit auf Organisationsebene bleibt in Pathrule Web: Teamverwaltung, Pläne und Abrechnung sowie die workspaceübergreifende Übersicht erreichst du über Links, statt dass sie im Editor nachgebaut werden.

Hast du im lokalen Modus angefangen und willst einen Ordner deinem Team zur Verfügung stellen, meldet dich eine einzige Aktion an, wählt eine Organisation aus und kopiert den Workspace samt Inhalten in die Cloud. Deine lokale Kopie bleibt dabei als Rückfalloption erhalten.

Wann Pathrule für VS Code sinnvoll ist

Nutze die Erweiterung, wenn du hauptsächlich in VS Code, Cursor oder Windsurf arbeitest und den Wissensbaum des Workspace, die Inhaltsbearbeitung und die Agent-Einrichtung in dem Editor haben willst, der deinen geöffneten Ordner und deine aktive Datei ohnehin kennt. Starte in Sekunden im lokalen Modus und melde dich später an, wenn du die Team-Ebene brauchst.

Wenn du im Terminal zu Hause bist oder Pathrule per Skript in deine CI einbindest, greif lieber zur Pathrule CLI. Beide teilen sich dieselbe Anmeldung, du kannst also auch beide nutzen.

  • Pathrule CLI für die terminalorientierte Laufzeitumgebung mit derselben Identität und denselben Hooks.
  • Open-Source-Kern dafür, was der lokale Modus ausführt und was Cloud ergänzt.
  • So funktionieren Hooks dafür, was die Erweiterung an deinen Assistenten übergibt.