Cursor

Cursor verbindet sich über Pathrule CLI oder die VS Code-Erweiterung mit deinem Pathrule-Workspace. Pathrule nutzt die nativen Hooks von Cursor und den lokalen MCP-Server, um pfadbezogenes Workspace-Wissen bereitzustellen. Cursor hat Session- und Tool-Hooks, aber keinen Prompt-Submit-Hook. Der Kontext kommt deshalb beim Start der Session und rund um Tool-Aufrufe an, nicht mit jedem Prompt. Cursor verwendet den lokalen MCP-Server; ein Remote-MCP-Setup ist für Cursor nicht dokumentiert.

Diese Seite beschreibt, was Pathrule für Cursor in dein Projekt schreibt, wie sich die Hook-Events zwischen den Clients entsprechen und wie du die Integration prüfst.

Was Pathrule schreibt

Wenn du Pathrule in Cursor installierst, bekommst du:

• .cursor/hooks.json. Die native Hook-Konfiguration von Cursor. Pathrule registriert hier die Events, die es braucht, und lässt Hooks, die du selbst angelegt hast, unangetastet.
• Einen MCP-Server-Eintrag in ~/.cursor/mcp.json. Deine Cursor-MCP-Konfiguration auf Benutzerebene, die auf den lokalen Pathrule-MCP-Server zeigt. Deine anderen Server bleiben, wie sie sind.
• .cursor/rules/pathrule-protocol.mdc, dazu .cursorrules für ältere Cursor-Versionen. Ist der Hook installiert, enthalten diese Dateien nur einen kurzen Hinweis, dass Pathrule aktiv ist und über den Hook ausgeliefert wird.
• Materialisierte Skills in .cursor/skills/<name>/SKILL.md, damit Cursor sie über ihren Namen aufrufen kann.

Ist der Cursor-Hook installiert, kommt das Protokoll über sessionStart statt über die Regeldatei, und das Pfadwissen kommt über die Hooks. Es werden also keine Wissensdateien in deinen Verzeichnisbaum geschrieben. Ohne Hook enthält die Regeldatei das vollständige Protokoll und die Workspace-Übersicht, und Pathrule legt für jedes Verzeichnis mit zugeordnetem Wissen eine per Glob eingegrenzte Regel .cursor/rules/pathrule-k-*.mdc an.

Ein Skills-Schalter eines Drittanbieters ist nicht nötig. Cursor sieht den von der CLI verwalteten Pathrule-Hook-Provider direkt.

Abdeckung der Hook-Events

Die Events von Cursor entsprechen den Injektionspunkten von Pathrule:

• sessionStart. Wenn eine neue Session beginnt. Pathrule liefert die Workspace-Metadaten, das Protokoll und deinen Team-Kontext, also denselben Bootstrap, den Claude Code beim Start seiner Session erhält.
• preToolUse. Bevor Cursor ein Tool ausführt. Hier verweigert eine Regel mit freigegebenem Blockiermuster eine passende Bearbeitung oder einen passenden Schreibvorgang und gibt als Begründung die Regel und die freigegebene Abhilfe an. Auf Cursor transportiert dieses Event nur die Entscheidung; der pfadbezogene Kontext wird stattdessen über sessionStart und postToolUse geliefert.
• postToolUse. Nachdem ein Tool fertig ist. Pathrule nutzt dieses Event sowohl, um Aktivität zu erfassen, als auch als Ausgleichspunkt für den pfadbezogenen Kontext, den das Pre-Tool-Event von Cursor nicht transportieren kann.
• stop, subagentStop und sessionEnd. Schließen den Turn und die Session ab.

Das Prompt-Event von Cursor wird bewusst nicht registriert: Seine Ausgabe kann keinen Kontext transportieren, und sessionStart zusammen mit postToolUse deckt dasselbe ab.

Ein einziges gemeinsames Hook-Skript gleicht die Unterschiede im Event-Format zwischen Cursor und Claude Code aus. Darum musst du dich nicht kümmern: Installiere Cursor über Pathrule, und das richtige Format ist gesetzt.

Isolation pro Client

Pathrule unterstützt jede Kombination von KI-Clients auf einem Rechner.

• Nur Cursor. Pathrule schreibt nur die Cursor-Konfigurationen.
• Nur Claude Code. Pathrule schreibt nur die Claude-Code-Konfigurationen.
• Beide. Pathrule schreibt beide. Die Hooks werden unabhängig voneinander registriert, der MCP-Server wird gemeinsam genutzt, der Inhaltsbaum ist derselbe.

Maßgeblich ist, was du auswählst, wenn das Pathrule-Setup fragt, welche KI-Tools du verwendest, 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 Cursor, wenn nach deinen KI-Tools gefragt wird. Das Setup meldet dich bei Bedarf bei Pathrule Cloud an, verknüpft den Ordner mit einem Workspace, installiert den MCP-Eintrag, merkt sich deine Auswahl für diesen Ordner und schreibt die Cursor-Dateien. Mit pathrule setup --local nutzt du Pathrule stattdessen ganz ohne Konto.

So verdrahtest du die Teile von Hand in einem Ordner, der bereits verknüpft ist:

pathrule install cursor
pathrule sync
pathrule doctor

pathrule install cursor fügt den Pathrule-Server zu ~/.cursor/mcp.json hinzu und lässt deine anderen Server in Ruhe. pathrule sync schreibt 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.

In der VS Code-Erweiterung, die auch in Cursor läuft, wählst du Cursor unter Connect AI Clients. Die Erweiterung schreibt über ihre mitgelieferte CLI denselben MCP-Eintrag und dieselbe Hook-Konfiguration.

Prüfen

Öffne Cursor in einem Verzeichnis, das du mit einem Workspace verknüpft hast. Öffne den Tab Hooks Settings und prüfe, ob Pathrule als registrierter Provider erscheint. Starte einen neuen Chat. Der pfadbezogene Kontext sollte vor dem ersten Tool-Aufruf erscheinen.

Wenn die Integration stumm bleibt:

pathrule doctor

Der Doctor arbeitet rein lesend. Er meldet deine Anmeldung, deinen Workspace und ob dieser Ordner verknüpft ist, ob der Pathrule-MCP-Eintrag für Cursor und jeden anderen Client installiert ist und welche von Pathrule verwalteten Dateien im Ordner liegen und wer sie geschrieben hat. Mit --json bekommst du den vollständigen Bericht, der auch einen MCP-Eintrag markiert, der auf eine nicht mehr vorhandene Runtime zeigt. pathrule repair schreibt einen veralteten Eintrag neu, synchronisiert die Projektdateien erneut, einschließlich .cursor/hooks.json, und führt den Doctor noch einmal aus.

Was gleich bleibt

Alles, was du in Pathrule schreibst, kommt bei Cursor in derselben Form an wie bei Claude Code.

• Eine Memory, die mit der CLI, der VS Code-Erweiterung oder über MCP geschrieben wurde, erscheint in beiden.
• Eine Regel mit freigegebenem Blockiermuster blockiert in beiden eine passende Bearbeitung.
• Ein Skill lässt sich in beiden über seinen Namen aufrufen.
• Die MCP-Tools (pathrule_get_context, pathrule_write_memory usw.) verhalten sich identisch.

Was du für einen Assistenten bereitstellst, bekommst du auch für den anderen.

Weiterlesen

• Claude Code für die Schwester-Integration.
• So funktionieren Hooks für das zugrunde liegende Modell.
• MCP-Tools-Referenz für jedes Tool, das der Assistent aufrufen kann.