Wat is de PocketHook Safari-extensie?#
Een Safari-extensie voor macOS waarmee je zelfgehoste Agent Server in je echte browser kan werken: tabbladen openen en sluiten, pagina’s lezen, bedieningselementen vinden en aanklikken, formulieren invullen en screenshots maken — in jouw sessie, met jouw logins, op jouw machine.
Alles draait lokaal. De extensie praat alleen met de Agent Server op je eigen Mac (loopback), en er wordt niets ergens anders naartoe gestuurd.
Installatie#
De extensie wordt met de Agent Server meegeleverd als een genotariseerde macOS-app — geen App Store, geen Xcode:
bun run safari:install
Dit installeert Pockethook Safari.app in /Applications en start de app. Vervolgens, in Safari:
- Instellingen → Extensies — schakel PocketHook Safari in en verleen toegang tot websites.
- Genereer een eenmalige koppelcode op de server:
bun run safari:code
- Open de popup van de extensie in de Safari-knoppenbalk, voer de code in en druk op Pair. Een groene stip betekent dat je verbonden bent.
Controleer de verbinding op elk moment met bun run safari:status.
Machtigingsniveaus#
Jij bepaalt hoeveel autonomie de agent krijgt, per server, met bun run safari:config:
| Niveau | Wat het betekent |
|---|---|
confirm (standaard) | Elke klik met externe effecten (stemmen, versturen, publiceren, kopen…) vraagt eerst jouw toestemming |
autonomous | Stemmen, volgen en versturen gebeuren zonder te vragen; betalingen, permanente verwijderingen en account- of beveiligingswijzigingen vragen nog steeds |
readonly | Alleen navigeren, inspecteren en vastleggen — klikken en typen zijn uitgeschakeld |
Wat de agent kan doen#
- Tabbladen openen, navigeren en sluiten
- Een pagina inspecteren: zichtbare bedieningselementen met stabiele selectors, status en semantische attributen
- Bedieningselementen vinden via hun zichtbare tekst of identificerende attributen
- Klikken en formulieren invullen (framework-bewust, met verificatie vooraf/achteraf)
- Scrollen en screenshots maken, die teruggestuurd worden naar je chat
Elke actie rapporteert wat er werkelijk is gebeurd — inclusief of een klik echt iets heeft veranderd — zodat de agent verifieert in plaats van gokt.
Beveiligingsmodel#
- Alleen loopback — de extensie maakt uitsluitend verbinding met lokale adressen die jij configureert.
- Eenmalige koppelcodes — codes verlopen na 5 minuten en zijn eenmalig te gebruiken; de resulterende credential verlaat je Mac nooit.
- Verval van commando’s — commando’s die de extensie niet binnen 20 seconden ophaalt, worden verworpen, zodat niets te laat wordt uitgevoerd.
- Jij houdt de sleutels — betalingen en destructieve acties vereisen altijd jouw expliciete bevestiging, op elk machtigingsniveau dat klikken toestaat.
- Auditeerbaar — de JavaScript van de extensie wordt leesbaar meegeleverd in de app-bundel.
Download#
De extensie is gebundeld met de Agent Server (assets/safari/PocketHook-Safari.zip), of haal hem direct op: PocketHook-Safari.zip — ondertekend en genotariseerd voor macOS.