Zum Inhalt springen

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.

  1. 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.

    1. Vorlage für einen Sessionstart-Hook erstellen
      /create-hook SessionStart project-start --ts

  2. 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
            }
          ]
        }
      ]
    }
  3. 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.

    1. 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 Dokumentation

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.

Gut zu wissen, bevor du startest.

Erstellt die KI Hook-Vorlagen?
/create-hook schreibt eine Vorlage und registriert sie. Prüfe und passe das Skript selbst an, bevor du seine Ausführung freigibst.
Beweist Validierung, dass ein Hook sicher ist?
Nein. /hooks validate prüft grundlegende Konfiguration und referenzierte Skriptstruktur. Prüfe Skript, Rechte und Ziele separat.
Wird jede Hook-Ausführung erneut bestätigt?
Davon solltest du nicht ausgehen. Eine Startfreigabe für das Projekt kann konfigurierte Hooks ohne eigene Rückfrage bei jeder Ausführung laufen lassen.

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.

Eine bewusste Entscheidung

Vor dem ersten Prompt.

Interaktive Demo
Lurus Codeprivacy-demo · beispielhafter Workspace

Demo-Sitzung bereit. Modellwahl und Datenweg sind getrennte Entscheidungen.

Inszeniertes Beispiel. Keine echte Anmeldung, Sicherheitsprüfung oder Codeübertragung.

Bildvorschau