bellinivitor/astro

astro:gate — Editor der Gate-Regeln

Öffnet die Mini-App ai-gate/ (SQLite + Web-UI) im Browser, um die Regeln zu bearbeiten, mit denen das Gate verbotene Befehle blockiert. Es ist das editierbare Gegenstück zu astro:setup (das das Gate installiert).

Schritt 1 — Stelle sicher, dass das Gate installiert ist

• Es muss ai-gate/app.py im Projektstammverzeichnis existieren. Wenn nicht, führe zuerst astro:setup aus (es installiert ai-gate/ und erzeugt das Gate).

Schritt 2 — Starte die App

• Führe python3 ai-gate/app.py aus (Standardport 8787; verwende --port N, falls der Port belegt ist). Der Server läuft lokal (127.0.0.1) und bleibt aktiv – starte ihn im Hintergrund, um die Sitzung nicht zu blockieren.
• Öffne http://127.0.0.1:8787 im Browser (falls die Umgebung einen eingebetteten Browser hat, öffne ihn dort; andernfalls gib die URL an den Benutzer weiter).

Schritt 3 — Bearbeiten und generieren

• In der UI: Füge Regeln hinzu, bearbeite sie, deaktiviere oder entferne sie (Regex oder Literaltext).
• Klicke auf Gate generieren, um .claude/hooks/astro_gate.py mit den aktiven Regeln neu zu schreiben. Die SQLite-Datenbank (ai-gate/rules.db) ist die Quelle der Wahrheit; das Skript ist ein generiertes Artefakt – bearbeite es nicht manuell.
• Beende den Server nach Abschluss (Strg+C im Prozess).

Das generierte astro_gate.py ist eigenständig (eingebettete Regeln) und kann daher auch als CLI in VM/CI ausgeführt werden: python3 astro_gate.py "$CMD" && eval "$CMD".