Was ist die PocketHook-Safari-Erweiterung?#
Eine Safari-Erweiterung für macOS, mit der dein selbst gehosteter Agent Server in deinem echten Browser arbeiten kann: Tabs öffnen und schließen, Seiten lesen, Bedienelemente finden und anklicken, Formulare ausfüllen und Screenshots aufnehmen — in deiner Sitzung, mit deinen Logins, auf deinem Rechner.
Alles läuft lokal. Die Erweiterung spricht nur mit dem Agent Server auf deinem eigenen Mac (Loopback), und nichts wird irgendwo anders hingeschickt.
Installation#
Die Erweiterung wird mit dem Agent Server als notarisierte macOS-App ausgeliefert — kein App Store, kein Xcode:
bun run safari:install
Das installiert Pockethook Safari.app in /Applications und startet sie. Danach in Safari:
- Einstellungen → Erweiterungen — aktiviere PocketHook Safari und gewähre Website-Zugriff.
- Erzeuge einen einmaligen Kopplungscode auf dem Server:
bun run safari:code
- Öffne das Popup der Erweiterung in der Safari-Symbolleiste, gib den Code ein und drücke Pair. Ein grüner Punkt bedeutet, dass du verbunden bist.
Prüfe die Verbindung jederzeit mit bun run safari:status.
Berechtigungsstufen#
Du entscheidest, wie viel Autonomie der Agent bekommt, pro Server, mit bun run safari:config:
| Stufe | Was sie bedeutet |
|---|---|
confirm (Standard) | Jeder Klick mit externer Wirkung (abstimmen, absenden, veröffentlichen, kaufen…) fragt dich zuerst |
autonomous | Votes, Follows und Absendungen laufen ohne Nachfrage; Zahlungen, endgültige Löschungen sowie Konto- oder Sicherheitsänderungen fragen weiterhin nach |
readonly | Nur navigieren, inspizieren und aufnehmen — Klicken und Tippen sind deaktiviert |
Was der Agent kann#
- Tabs öffnen, darin navigieren und sie schließen
- Eine Seite inspizieren: sichtbare Bedienelemente mit stabilen Selektoren, Zustand und semantischen Attributen
- Bedienelemente über ihren sichtbaren Text oder identifizierende Attribute finden
- Klicken und Formulare ausfüllen (framework-bewusst, mit Verifikation vorher/nachher)
- Scrollen und Screenshots aufnehmen, die zurück in deinen Chat geliefert werden
Jede Aktion meldet, was tatsächlich passiert ist — einschließlich der Frage, ob ein Klick wirklich etwas verändert hat — sodass der Agent verifiziert, statt zu raten.
Sicherheitsmodell#
- Nur Loopback — die Erweiterung verbindet sich ausschließlich mit lokalen Adressen, die du konfigurierst.
- Einmalige Kopplungscodes — Codes laufen nach 5 Minuten ab und gelten nur einmal; die daraus entstehende Zugangsberechtigung verlässt deinen Mac nie.
- Befehlsverfall — Befehle, die die Erweiterung nicht innerhalb von 20 Sekunden abholt, werden verworfen, sodass nichts verspätet ausgeführt wird.
- Du hältst die Schlüssel — Zahlungen und destruktive Aktionen erfordern immer deine ausdrückliche Bestätigung, auf jeder Berechtigungsstufe, die Klicken erlaubt.
- Auditierbar — das JavaScript der Erweiterung liegt lesbar im App-Bundle.
Download#
Die Erweiterung ist im Agent Server enthalten (assets/safari/PocketHook-Safari.zip), oder lade sie direkt herunter: PocketHook-Safari.zip — signiert und notarisiert für macOS.