Hooks
Projektskripte automatisch ausführen.
Hooks starten deine Skripte bei bestimmten Agentenereignissen – zum Beispiel beim Sessionstart oder vor und nach einem Werkzeugaufruf. So bindest du eigene Checks und Projektroutinen in den Ablauf ein.
In drei Schritten einrichten.
-
Vorlage für einen Sessionstart-Hook erstellen
Erstelle im Lurus-Code-Chat eine Vorlage für das gewünschte Ereignis. Verwende einen neuen Namen, damit keine vorhandene Skriptdatei überschrieben wird.
- Vorlage für einen Sessionstart-Hook erstellen
/create-hook SessionStart project-start --ts
-
-
Skript und Zuordnung bearbeiten
Passe das erzeugte TypeScript-Skript unter .lurus/hooks/ an. Dieses Beispiel protokolliert den Sessionstart, ohne ihn zu blockieren. Es benötigt Node.js und tsx. Behalte den erzeugten Pfad in .lurus/hooks.json oder ersetze ihn durch den tatsächlichen Skriptpfad.
.lurus/hooks/project-start.ts
process.stdin.resume(); process.stdin.on('end', () => { console.error('Project session started.'); console.log(JSON.stringify({ decision: 'allow' })); });.lurus/hooks.json
{ "SessionStart": [ { "hooks": [ { "type": "command", "command": "npx tsx .lurus/hooks/project-start.ts", "timeout": 30000 } ] } ] } -
Validieren und aktivieren
Prüfe die Konfiguration mit /hooks validate. Starte anschließend eine neue Session, bestätige die Hook-Ausführung für das Projekt und teste deine Routine.
- Projekt-Hook-Konfiguration validieren
/hooks validate
-
Hooks verwalten
Ändere oder entferne die Zuordnung in .lurus/hooks.json und lade sie mit einer neuen Session. Globale Hooks liegen unter ~/.lurus/hooks.json. Weitere Ereignisse und Matcher findest du in der Dokumentation.
Zur DokumentationHooks führen Skripte aus. Prüfe Befehle vor der Startfreigabe für das Projekt; freigegebene Hooks können ohne Rückfrage bei jeder einzelnen Ausführung laufen.
Gut zu wissen, bevor du startest.
Erstellt die KI Hook-Vorlagen?
Beweist Validierung, dass ein Hook sicher ist?
Wird jede Hook-Ausführung erneut bestätigt?
Hooks
Eine nützliche Routine nah am Workflow halten.
Wähle das Ereignis, prüfe das Skript und teste die Routine vor der Freigabe für dein Projekt.
Hooks führen Skripte aus. Prüfe Befehle vor der Startfreigabe für das Projekt; freigegebene Hooks können ohne Rückfrage bei jeder einzelnen Ausführung laufen.
Du möchtest mit deinem Team starten? Sprich mit uns.