Windsurf

Anbieter: Devin Desktop (vormals Codeium Windsurf) Installationsname: windsurf Status: GA Native Konfiguration: <project>/.devin/rules/apothem-rules.md

Windsurf ist jetzt Devin Desktop, und .devin/rules/ ist der bevorzugte Speicherort für Workspace-Regeln (er hat Vorrang vor .windsurf/rules/).

InstallationCopy Anchor Link

apothem install --harness windsurf --project /path/to/project

Der Adapter schreibt aus der gemeinsamen Regel- und Governance-Oberfläche von Apothem eine Windsurf-Regeldatei mit Projektgeltungsbereich, schreibt elf der Helfer von Apothem als Devin-Local-Subagenten in das Projekt (siehe Subagenten) und registriert zwei Devin-Local-Hooks (siehe Hooks).

Außerdem schreibt er die Skills von Apothem sowie die Regeln und Templates, auf die sie verweisen, in Ihr Home-Verzeichnis, bevor er das Projekt anfasst (siehe Dateien außerhalb des Projekts).

Geschriebene Dateien:

• <project>/.devin/rules/apothem-rules.md, die Regeldatei.
• <project>/.devin/agents/<name>.md für elf Apothem-Helfer, im Projekt.
• <project>/.devin/config.local.json, die Hook-Registrierung, im Projekt. Ihre eigenen Einträge darin bleiben erhalten.
• <project>/.apothem/support/windsurf/hooks/, die Hook-Skripte, im Projekt.
• ~/.agents/skills/<name>/SKILL.md für jeden Apothem-Skill und -Befehl, in Ihrem Home-Verzeichnis.
• ~/.config/apothem/rules/ und ~/.config/apothem/templates/, in Ihrem Home-Verzeichnis.

Dateien außerhalb des ProjektsCopy Anchor Link

Die Installation schreibt außerdem die Skills von Apothem in Ihr Home-Verzeichnis, bevor sie irgendetwas im Projekt ändert:

Diese Ordner werden gemeinsam genutzt. Sie gehören nicht exklusiv zum Projekt:

• Jedes Projekt, in das Sie windsurf installieren, und jede andere Apothem-Installation, die den Ordner nennt, nutzt dieselbe Kopie und schreibt dieselben Dateien, daher spielt die Reihenfolge Ihrer Installationen keine Rolle. Mehrere andere Werkzeuge lesen ~/.agents/skills/ ebenfalls; die Harness-Registry listet sie auf.
• --project legt fest, welche Regeldatei geschrieben wird und zu welchem Projekt die Installation gehört. Es ändert nicht, wohin die Skills gehen.
• Die Installation fügt Ihrem Repository keine Skill- oder Regeldatei hinzu. Das Projekt erhält die Regeldatei, die Subagenten-Dateien in .devin/agents/, die Hook-Registrierung in .devin/config.local.json sowie den Ordner .apothem/, den jede Projektinstallation anlegt und der auch die Hook-Skripte enthält.
• Die Home-Ordner werden zuerst geschrieben. Schlägt das fehl, etwa weil ein Ordner im Pfad ein Link ist, der aus Ihrem Home-Verzeichnis herausführt (einem Link, der darin bleibt, wird gefolgt), oder nicht beschreibbar ist, bricht die Installation mit dem Fehler ab, bevor sich im Projekt etwas ändert.
• Ein Skill-Ordner mit dem Namen eines Apothem-Skills, den Apothem nicht geschrieben hat, bleibt unangetastet, und die Installation gibt eine Warnung aus, die ihn nennt. Benennen Sie ihn um oder verschieben Sie ihn und führen Sie dann apothem update aus. apothem verify schlägt fehl, solange dieser Name belegt ist.
• Die Dateien umfassen zusammen einige Megabyte.

Die Installation gibt einen Hinweis aus, der die Ordner nennt, die sie außerhalb von --project schreibt, und --dry-run listet sie auf.

SubagentenCopy Anchor Link

Devin Local, mit dem neue Tabs in Devin Desktop starten, liest einen Subagenten aus einer Markdown-Datei in <project>/.devin/agents/, laut der Devin-Dokumentation zu Subagenten. Cascade, der ältere Modus, hat keine Subagenten. Die Installation schreibt elf der vierzehn Helfer von Apothem in diesen Ordner. Sie installiert nur für das Projekt und schreibt keinen Subagenten-Ordner auf Benutzerebene (~/.config/devin/agents/ unter Linux und macOS, %APPDATA%\devin\agents\ unter Windows).

Jede Datei behält die Anweisungen des Helfers unverändert bei und trägt diese Frontmatter-Schlüssel:

Devin hat keinen Schlüssel, der ein Werkzeug verweigert, daher werden die erlaubten Werkzeuge des Helfers abzüglich seiner verweigerten Werkzeuge zu der einen Liste allowed-tools. Das Bash des Helfers heißt in Devin exec, und ein Werkzeug, für das Devin keinen aufgeführten Namen hat, wird weggelassen. Schreibgeschützte Helfer erhalten read, glob und grep, dazu exec für diejenigen, die Befehle ausführen, und niemals write oder edit.

Drei Helfer werden nicht installiert: citation-auditor, fact-checker und research-scout. Sie benötigen Websuche und Web-Abruf, und Devin dokumentiert für keines von beiden einen allowed-tools-Namen, daher hält die Installation sie zurück, statt eine Version zu schreiben, die nicht recherchieren kann, oder eine, die jedes Werkzeug hat. Eine eigene Datei in .devin/agents/ mit einem dieser Namen wird nie angefasst.

Die Installation schreibt keinen Schlüssel model. Devin führt einen Subagenten auf seinem eigenen Standard-Subagentenmodell aus, das nicht das Modell der Sitzung ist, die ihn gestartet hat. Sie schreibt außerdem kein max-nesting und keinen der Apothem-Schlüssel maxTurns, version, updated und portability.

Gut zu wissen:

• Benutzerdefinierte Subagenten sind experimentell. Devin kennzeichnet Format und Optionen als änderbar, und Devin Desktop hat in den Devin Settings einen Schalter Subagents (Preview) (die Devin-CLI-Einstellung subagents_enabled ist standardmäßig eingeschaltet).
• Die Subagenten-Dateien sind gewöhnliche Projektdateien. Committen Sie sie mit dem Projekt oder tragen Sie .devin/agents/ in .gitignore ein; Apothem entscheidet das nicht für Sie.
• Eine eigene Datei mit dem Namen eines Apothem-Helfers wird unter ~/.apothem/backups/ gesichert und dann ersetzt. Die Deinstallation stellt sie nicht wieder her. Dateien mit anderen Namen werden nie angefasst.
• Devin liest außerdem den gemeinsamen Ordner .agents/agents/, den Apothem nie schreibt, und die Devin CLI dokumentiert einen Import von Subagenten aus einem Ordner .claude/, ohne den Pfad zu nennen. Devin Local findet seine Dateien auf dieselbe Weise wie die Devin CLI, daher gilt dieser Import auch dort.
• Apothem hat nicht bestätigt, welche allowed-tools-Namen für Web-Werkzeuge gelten, welche Werte model akzeptiert oder wie eine leere allowed-tools-Liste gelesen wird.

HooksCopy Anchor Link

Devin Local führt Hooks aus dem Schlüssel hooks seiner Konfigurationsdateien aus, laut der Devin-Dokumentation zu Hooks. Die Installation registriert zwei:

Beide fügen dem Modell Kontext hinzu. Keiner blockiert einen Werkzeugaufruf oder eine Sitzung.

Apothem registriert bei Devin keinen PreToolUse-Guard. Devins Dokumentation führt additionalContext (das Feld, über das die Guards von Apothem sprechen) für UserPromptSubmit, SessionStart und PostToolUse auf und für PreToolUse nur eine Entscheidung und eine Umschreibung der Eingabe. Ein dort registrierter Guard würde bei jedem Werkzeugaufruf einen Prozessstart kosten und möglicherweise nichts zustellen, daher bleiben die Schreib-, Bearbeitungs- und Shell-Guards, die Prüfung von AskUserQuestion und das Sitzungsende-Protokoll bei den Werkzeugen, die sie zustellen. Apothem wird einen Guard für ein Devin-Ereignis registrieren, sobald die Dokumentation oder ein Test zeigt, dass er das Modell erreicht.

Dies sind Devin-Local-Hooks. Der ältere Cascade-Modus liest ein anderes Hook-Format (.devin/hooks.json), das die Installation nicht schreibt.

Wohin die Dateien gehen

Jeder registrierte Befehl nennt den Interpreter, den Apothem bei seinem Lauf gefunden hat, und den absoluten Pfad des Projekts, ist also maschinenspezifisch. Deshalb schreibt die Installation die lokale Datei und niemals die gemeinsame <project>/.devin/config.json, die eigenständige .devin/hooks.v1.json oder die .claude/-Einstellungen. Die Installation bearbeitet .gitignore nicht. Devin schließt seine lokalen Konfigurationsdateien selbst von git aus (über .git/info/exclude), sodass der Checkout eines Teammitglieds keine Befehle erhält, die auf Ihre Maschine zeigen; prüfen Sie, dass Ihre .gitignore .apothem/ enthält.

Pfade, die die Shell falsch lesen würde. Ein Projekt- oder Interpreterpfad, der $, einen Backtick, ein doppeltes Anführungszeichen oder einen Backslash enthält, wird abgelehnt, bevor etwas geschrieben wird: Innerhalb des angeführten Befehls würde er eine andere Datei ausführen oder das JSON zerstören, in das der Befehl geschrieben wird. Der Fehler nennt den Pfad; verschieben oder benennen Sie das Projekt um und führen Sie die Installation erneut aus. Ein Leerzeichen oder ein Apostroph in einem Pfad ist in Ordnung.

Ein Befehl sieht so aus, mit Ihrem Interpreter- und Projektpfad anstelle der beiden Pfade:

"/path/to/python" "/path/to/project/.apothem/support/windsurf/hooks/dispatch.py" --contract devin SessionStart

--contract devin bildet Devins kleingeschriebene Werkzeugnamen (exec, write, edit, read, grep, glob) auf die Namen ab, die die Handler von Apothem prüfen, und belässt die Ausgabe als denselben Umschlag, den Claude Code liest. Es wird kein Matcher geschrieben: Devins Matcher ist ein regulärer Ausdruck, ein weggelassener passt auf jedes Werkzeug, und SessionStart hat kein Werkzeug, auf das er passen könnte.

Was Sie nach der Installation prüfen sollten

• Devin führt keinen Hook aus, solange sich der Workspace im Restricted Mode befindet. Vertrauen Sie dem Workspace zuerst.
• Um zu sehen, ob die Hooks geladen wurden, öffnen Sie den Tab Hooks in den Customizations von Devin Local oder führen Sie /hooks in der Devin CLI aus. Beide listen jeden Hook mit seiner Quelldatei auf.
• Devins Dokumentation nennt keine Shell für Hook-Befehle unter Windows. Die Befehle verwenden sh-Quoting, das PowerShell ohne einen Aufrufoperator nicht parsen würde. Apothem hat nicht bestätigt, was Devin Local unter Windows ausführt; wenn die Hooks dort nicht laden, melden Sie das in einem Issue.

Devin führt auch die Hooks aus, die Claude Code geschrieben hat. Devin lädt die Hooks in ~/.claude/settings.json, .claude/settings.json und .claude/settings.local.json, solange read_config_from.claude eingeschaltet ist, was die Standardeinstellung ist: Devin Local findet seine Dateien auf dieselbe Weise wie die Devin CLI. Wenn Sie Apothem auch für Claude Code installiert haben, können beide Hook-Sätze laufen. Der SessionStart-Befehl hier und dessen Kopie für Claude Code teilen sich eine Markierung pro Sitzung im Hook-Zustandsordner von Apothem, sodass der zweite, der läuft, still bleibt und der Bootstrap das Modell einmal erreicht; Apothem erkennt Devin an der Variablen DEVIN_PROJECT_DIR, die Devin für seine Hooks setzt. Die Markierung gilt zehn Sekunden, sodass ein späterer Start derselben Sitzung dennoch zustellt. Der Zähler für die Kontextgröße läuft an beiden Stellen, sodass seine Schwellenwerte früh erreicht werden, und Apothem dedupliziert die Zähler nicht. Um nur diese Hooks zu laden, setzen Sie "claude": false unter "read_config_from" in Ihrer Benutzerkonfiguration (~/.config/devin/config.json oder %APPDATA%\devin\config.json unter Windows) oder in der .devin/config.json des Projekts; das verhindert auch, dass Devin die Regeln, Skills, Befehle und MCP-Server von Claude Code importiert. Die Installation gibt dies als Hinweis aus.

Ihre eigenen Hooks. Die Registrierung wird schlüsselweise in Ihre Datei eingefügt. Hooks und andere Schlüssel, die Sie geschrieben haben, bleiben, wie sie waren, ein eigener Handler unter demselben Ereignis bleibt neben dem von Apothem bestehen, und eine Aktualisierung ersetzt nur die Handler, deren Befehl den Apothem-Dispatcher ausführt (.apothem/support/windsurf/hooks/dispatch.py mit --contract devin, unter welchem Projektpfad er auch geschrieben wurde). Ein eigener Hook, der nur den Namen teilt oder python -m apothem.conformity.gate ausführt, wird nie für einen von Apothem gehalten. Eine Datei mit Kommentaren oder anderer JSON5-Syntax lässt sich nicht neu schreiben, ohne diese zu verlieren, daher meldet die Installation für diese Datei einen Fehler config.unparseable, lässt sie unangetastet und bricht ab, wobei die anderen Dateien, die sie zu schreiben begonnen hatte, wieder entfernt werden: Entfernen Sie die Kommentare oder fügen Sie die beiden Einträge selbst hinzu.

Die Hooks ausschalten. Setzen Sie APOTHEM_HOOKS_DISABLE=1 in Devins Umgebung, um die Apothem-Hooks stummzuschalten.

Zuordnung von Profil zu nativer KonfigurationCopy Anchor Link

Der Adapter liest Apothems gemeinsames Profil und rendert die Regeldatei des Projekts bei jedem Lauf von apothem install oder apothem update. Das gemeinsame Profil ist die Quelle der Wahrheit; projektlokale Änderungen an der generierten Datei werden gesichert, bevor die nächste Synchronisierung den von Apothem verwalteten Inhalt ersetzt.

Die Datei beginnt mit ihrem Frontmatter trigger: always_on, das den Aktivierungsmodus der Regel festlegt. Der von Apothem verwaltete Block folgt darauf; Text, den Sie nach dem Block hinzufügen, bleibt bei jeder Synchronisierung erhalten.

KompatibilitätshinweiseCopy Anchor Link

Die aktuelle Regel-Oberfläche von Windsurf hat Projektgeltungsbereich unter .devin/rules/ (der bevorzugte Speicherort, der Vorrang vor dem Abwärtskompatibilitäts-Fallback .windsurf/rules/ hat). Workflows und maschinenlokale Memories gehören dem Operator; Apothem schreibt sie nicht, ebenso wenig die Cascade-Hook-Datei oder die gemeinsame Devin-Konfiguration. Die Einzeldatei-Form .windsurfrules wird absichtlich nicht geschrieben.

Devin Desktop (Windsurf) erkennt ~/.agents/skills/, sodass die Skills, die die Installation schreibt, ohne weitere Einrichtung erscheinen. Sein Import aus Claude Code, standardmäßig eingeschaltet, liest Skills nur aus dem Ordner .claude/skills/ des Projekts; daher ist nicht dokumentiert, dass die Skills, die eine Installation von Apothem für Claude Code in ~/.claude/skills/ schreibt, dort ebenfalls erscheinen. Apothem hat nicht bestätigt, wie Windsurf einen SKILL.md-Header-Schlüssel behandelt, den es nicht auflistet; die Skills tragen user-invocable, disable-model-invocation, allowed-tools, argument-hint und eine metadata-Map.

VerifizierungCopy Anchor Link

apothem verify --harness windsurf --project /path/to/project

Der Befehl verify bestätigt Folgendes:

1. Die native Konfiguration existiert am erwarteten Pfad.
2. Jedes verwaltete Ziel existiert, einschließlich des Ordners .devin/agents/ und der Hook-Registrierung .devin/config.local.json; verwaltete Dateien sind nicht leer, und JSON- oder YAML-Konfigurationen lassen sich parsen. Die Hook-Datei muss einen Handler enthalten, der den Apothem-Dispatcher ausführt (die Prüfung führt ihn nicht aus), sodass eine zurückgesetzte oder geleerte Datei die Verifizierung nicht mehr besteht. Fügen Sie --profile PATH hinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen. Für .devin/agents/ wird geprüft, dass der Ordner existiert, nicht, dass jede Helferdatei darin liegt; der Befehl apothem diff --harness windsurf --project /path/to/project listet die Helferdateien auf, die fehlen oder veraltet sind.
3. Jeder Apothem-Skill-Ordner ist mit einer SKILL.md vorhanden, gleich welche Installation ihn geschrieben hat, und kein Skill-Ordner mit einem Apothem-Namen gehört zu etwas, das Apothem nicht geschrieben hat. Eine fehlgeschlagene Prüfung nennt die fehlenden oder fremden Ordner.
4. Die adapterspezifische Verifizierungsroutine meldet Erfolg.

AktualisierungCopy Anchor Link

apothem update --harness windsurf --project /path/to/project

Leitet die Regeldatei des Projekts aus dem aktuellen Zustand des gemeinsamen Profils neu ab.

Die Aktualisierung schreibt außerdem jeden Skill-Ordner neu, dessen Dateien von den aktuellen abweichen. Wenn Sie mit einem früheren Release installiert haben, das keine Skills schrieb, fügt die Aktualisierung sie hinzu. Sie schreibt Subagenten-Dateien neu, die von den aktuellen abweichen, und fügt fehlende hinzu. Sie aktualisiert außerdem die Hook-Skripte und die Apothem-Handler in .devin/config.local.json und lässt Ihre eigenen Einträge unangetastet.

DeinstallationCopy Anchor Link

apothem uninstall --harness windsurf --project /path/to/project

Entfernt den Apothem-Block und das Frontmatter, das Apothem darüber geschrieben hat, aus <project>/.devin/rules/apothem-rules.md und behält jeden anderen Text darin. Die Datei wird nur gelöscht, wenn darin nichts anderes mehr übrig ist. Vor der Änderung wird eine mit Zeitstempel versehene Kopie der Datei unter ~/.apothem/backups/ gespeichert; im Projekt bleibt keine Sicherungsdatei zurück. Die YAML-Datei des gemeinsamen Profils und die Apothem-Engine bleiben unberührt.

Die Deinstallation entfernt außerdem die Subagenten-Dateien, die sie in <project>/.devin/agents/ geschrieben hat, und behält jede andere Datei dort; der Ordner wird entfernt, wenn er leer zurückbleibt. Sie entfernt die Apothem-Hook-Handler aus <project>/.devin/config.local.json, die sie am Dispatcher-Pfad in ihrem Befehl erkennt, und behält Ihre eigenen Hooks und Schlüssel. Die Datei wird nur gelöscht, wenn Apothem sie angelegt hat und darin nichts anderes mehr übrig ist. Die Hook-Skripte in <project>/.apothem/support/windsurf/hooks/ werden ebenfalls entfernt. Sie entfernt die Skill-Ordner, die sie in ~/.agents/skills/ geschrieben hat, sowie die Regeln und Templates in ~/.config/apothem/, aber nur, wenn keine andere Apothem-Installation sie noch nutzt. Ein anderes Projekt oder ein anderes Werkzeug, das den Ordner teilt, kann das tun. In diesem Fall behält die Deinstallation die Ordner, gibt aus, welche Installation sie nutzt, und die letzte Deinstallation entfernt sie. Dateien, die Sie diesen Ordnern hinzugefügt haben, bleiben bestehen, und ein leer zurückbleibender Ordner wird entfernt. Jeder Ordner wird unter ~/.apothem/backups/ gesichert, bevor er entfernt wird.

Konformitäts-GateCopy Anchor Link

python -m apothem.conformity.gate --all .

FehlerbehebungCopy Anchor Link

KonfigurationsschalterCopy Anchor Link

Siehe auchCopy Anchor Link

• Alle Harnesses — der vollständige Katalog der unterstützten Werkzeuge
• Installationsanleitung — Apothem in diesen Harness installieren
• Referenz zu apothem harnesses — Adapter über die CLI auflisten und untersuchen