Windsurf

Windsurf verbindet sich über Pathrule CLI oder die VS Code-Erweiterung mit deinem Pathrule-Workspace. Pathrule schreibt einen lokalen MCP-Servereintrag und eine begleitende Regeldatei, die Windsurf beim Start einer Session liest. Windsurf hat keine Hooks und erhält daher, anders als Claude Code, Codex, Cursor und GitHub Copilot, keinen Kontext über Hooks: Die Regeldatei enthält das Protokoll und die Workspace-Übersicht, alles Weitere liefern die MCP-Tools. Windsurf nutzt den lokalen MCP-Server; eine Einrichtung über Remote MCP ist für Windsurf nicht dokumentiert.

Diese Seite beschreibt, was Pathrule für Windsurf in dein Projekt schreibt, warum Windsurf dieselben Inhalte erhält wie jedes andere Tool und wie du die Integration selbst prüfst.

Was Pathrule schreibt

Wenn du Pathrule in Windsurf installierst, bekommst du:

• Einen MCP-Servereintrag in ~/.codeium/windsurf/mcp_config.json. Er verweist den Assistenten auf den lokalen Pathrule-MCP-Server, damit er die pathrule_*-Tools aufrufen kann, und lässt deine anderen Server unangetastet.
• Eine begleitende Anweisungsdatei, .windsurf/rules/pathrule-protocol.md, dazu .windsurfrules für ältere Windsurf-Versionen. Sie enthält die Workspace-Übersicht und das Pathrule-Protokoll, also im Kern dasselbe, was die anderen Clients in ihren eigenen Formaten erhalten.
• Pfad-Wissensdateien. Für jedes Verzeichnis mit hinterlegtem Wissen eine Regel .windsurf/rules/pathrule-k-*.md, die mit dem Verzeichnis beginnt, für das sie gilt.
• Materialisierte Skills in .windsurf/skills/<name>/SKILL.md, damit Windsurf sie über ihren Namen aufrufen kann.

Windsurf hat keinen Pathrule-Hook, deshalb erreichen Protokoll und Wissen Windsurf beim Session-Start über diese Dateien. Auf Clients mit Hooks liefert Pathrule dasselbe Protokoll inzwischen über den Session-Start-Hook und belässt in der Anweisungsdatei nur einen kurzen Hinweis; Windsurf behält die vollständige Datei, weil sonst nichts das Protokoll transportieren würde.

Die Begleitdatei wird nicht für jeden Client von Hand kopiert. Pathrule erzeugt sie mit einem gemeinsamen Renderer, der auch die Anweisungen für Claude Code, Cursor und Codex erstellt. So bleiben alle vier synchron, statt mit der Zeit auseinanderzulaufen.

Wie der Inhalt Windsurf erreicht

Jedes Tool, das MCP unterstützt, kann Pathrule über stdio nutzen: Du trägst den Pathrule-MCP-Befehl in die Client-Konfiguration ein, und der Assistent sieht dieselben Tools. Für Windsurf schreibt Pathrule CLI diese Konfiguration und rendert die Begleitdatei gleich mit. Die Begleitdatei liefert Workspace-Übersicht und Protokoll beim Session-Start, die MCP-Tools liefern alles Weitere bei Bedarf.

Zwei Dinge sorgen dafür, dass das ohne Abweichungen zwischen den Clients funktioniert.

• Ein Tool-Vertrag. Die MCP-Tools (pathrule_get_context, pathrule_read_memory, pathrule_write_memory und die übrigen) sind dieselben, die auch Claude Code und Cursor aufrufen. Der Assistent holt Kontext und schreibt Memories, Regeln und Skills über genau dieselbe Schnittstelle; nur die Client-Konfiguration ändert sich.
• Eine einzige Quelle der Wahrheit. Die Begleitdatei und die materialisierten Skills sind gerenderte Ansichten, nicht das Original. Eine Memory, die über die CLI, die VS Code-Erweiterung oder MCP geschrieben wurde, erreicht Windsurf in derselben Form wie jeden anderen Client.

Pathrule lädt den Quellcode deines Repositorys nicht automatisch hoch. Lokale Tools zum Lernen über das Projekt können die Dateien prüfen, die an einer Erkenntnis hängen, um sie zu validieren. Gespeichert werden das Wissen deines Teams (Memories, Regeln, Skills), die Aktivitäten, die Agents protokollieren, die Erkenntnisse, die Agents zusammen mit den zugrunde liegenden Dateien festhalten, und in einem Cloud-Workspace die Dateipfad-Paare, die Pathrule aus der jüngeren Git-Historie liest, um zu erkennen, welche Dateien gemeinsam geändert werden. Unter was Pathrule berechnet erfährst du, was im Cloud-Modus übertragen und gespeichert wird.

Eine Inhaltsschicht, viele Auslieferungsformate

Jeder Client liest ein anderes Anweisungsformat. Deshalb erzeugt Pathrule jede Begleitdatei mit demselben gemeinsamen Renderer, statt sie pro Tool von Hand zu kopieren. So bleibt das Windsurf-Protokoll inhaltlich identisch mit den Versionen für Claude Code, Cursor und Codex, auch wenn sich das Dateiformat unterscheidet.

Der Aufwand steckt in der Inhaltsschicht, nicht im Client. Dieselben Memories, Regeln und Skills bedienen Windsurf und jeden anderen Client, ohne dass du etwas neu schreiben musst.

Über die VS Code-Erweiterung

Windsurf ist ein Fork von VS Code. Wenn du die Pathrule-Erweiterung für VS Code in Windsurf nutzt, erkennt sie die Umgebung und schreibt denselben verwalteten MCP-Eintrag über den Installer, den auch die CLI verwendet, ohne dass du JSON von Hand bearbeitest. Der Eintrag verweist auf die mitgelieferte Pathrule-Runtime und enthält nie Geheimnisse.

Das ist ein weiterer Zugang zum selben Workspace, keine eigene Integration. Unter Pathrule für VS Code steht, was die Erweiterung macht, und unter Lokales und Remote MCP findest du die Unterschiede zwischen lokalem stdio und Remote MCP.

Isolation pro Client

Windsurf läuft auf demselben Rechner problemlos neben Claude Code, Cursor und Codex. Du kannst einen Client installieren, mehrere oder alle.

• Sie teilen sich denselben Pathrule-Workspace, denselben MCP-Server und denselben Inhaltsbaum.
• Die Konfigurationen, die jeder Client liest, sind unabhängig voneinander. Die Installation von Windsurf berührt die anderen nicht.
• Entfernst du einen Client, bleiben die übrigen und die Inhalte unverändert.

Welche Clients eingerichtet werden, hängt davon ab, was du auswählst, wenn das Pathrule-Setup nach deinen KI-Tools fragt, sei es in pathrule setup oder in der VS Code-Erweiterung.

Installation

Über Pathrule CLI:

pathrule setup

Führe den Befehl im Projektordner aus und wähle Windsurf, wenn nach deinen KI-Tools gefragt wird. Das Setup meldet dich bei Bedarf bei Pathrule Cloud an, verbindet den Ordner mit einem Workspace, installiert den MCP-Eintrag, merkt sich deine Auswahl für diesen Ordner und schreibt die Windsurf-Dateien. Mit pathrule setup --local nutzt du Pathrule stattdessen ohne Konto.

Um die Teile in einem bereits verbundenen Ordner von Hand einzurichten:

pathrule install windsurf
pathrule sync
pathrule doctor

pathrule install windsurf ergänzt den MCP-Eintrag in ~/.codeium/windsurf/mcp_config.json. pathrule sync rendert die Projektdateien für die KI-Tools, die für diesen Ordner ausgewählt wurden, oder, falls keine ausgewählt wurden, für die Tools, die es im Ordner erkennt.

Alternativ kannst du die VS Code-Erweiterung in Windsurf verwenden, wie oben beschrieben.

Prüfen

Öffne Windsurf in einem Verzeichnis, das du mit einem Workspace verbunden hast. Der Assistent sollte die Begleitdatei beim Session-Start lesen und pathrule_get_context für dein Arbeitsverzeichnis aufrufen können.

Schick einen Prompt, der einen Pfad mit Inhalten betrifft. Der Assistent sollte diese Inhalte über die MCP-Tools hervorholen. Falls das nicht klappt:

pathrule doctor

Der Doctor ändert nichts. Er meldet deine Anmeldung, den Workspace und ob dieser Ordner verbunden ist, ob der Pathrule-MCP-Eintrag für Windsurf und jeden anderen Client installiert ist und welche von Pathrule verwalteten Dateien im Ordner liegen und von wem sie geschrieben wurden. Mit --json erhältst du den vollständigen Bericht, der auch einen MCP-Eintrag markiert, der auf eine nicht mehr vorhandene Runtime verweist. pathrule repair schreibt einen veralteten Eintrag neu, rendert die Begleitdateien erneut und führt den Doctor noch einmal aus.

Was gleich bleibt

Die Inhaltsschicht ist bei allen Clients identisch.

• Dieselbe Memory, die Claude Code über den Hook erhält, erhält Windsurf über die MCP-Tools.
• Eine Regel erreicht Windsurf über die Begleitdatei und MCP. Windsurf hat keine Hooks, daher kann eine Regel dort keine Änderung blockieren; Blockieren vor dem Schreiben gibt es nur auf Clients mit Tool-Hooks: Claude Code, Codex, Cursor und GitHub Copilot.
• Ein Skill lässt sich über seinen Namen aufrufen.
• Die MCP-Tools verhalten sich identisch.

Was dein Team für einen Assistenten schreibt, bekommt jeder Assistent.

Weiterlesen

• Cursor für die verwandte Integration eines VS Code-Forks mit nativen Hooks.
• Lokales und Remote MCP dazu, warum die Tools überall dieselben sind.
• Pathrule für VS Code für die Erweiterung, die Windsurf direkt im Editor registrieren kann.
• So funktionieren Hooks für das Auslieferungsmodell hinter den Inhalten.