Cos’è l’estensione Safari di PocketHook?#
Un’estensione Safari per macOS che permette al tuo Agent Server self-hosted di lavorare dentro il tuo vero browser: aprire e chiudere schede, leggere pagine, trovare e cliccare controlli, compilare moduli e catturare screenshot — nella tua sessione, con i tuoi accessi, sulla tua macchina.
Tutto gira in locale. L’estensione parla solo con l’Agent Server sul tuo Mac (loopback), e nulla viene inviato altrove.
Installazione#
L’estensione viene fornita insieme all’Agent Server come app macOS notarizzata — niente App Store, niente Xcode:
bun run safari:install
Questo installa Pockethook Safari.app in /Applications e la avvia. Poi, in Safari:
- Impostazioni → Estensioni — abilita PocketHook Safari e concedi l’accesso ai siti web.
- Genera un codice di abbinamento monouso sul server:
bun run safari:code
- Apri il popup dell’estensione nella barra degli strumenti di Safari, inserisci il codice e premi Pair. Un punto verde significa che sei connesso.
Controlla la connessione in qualsiasi momento con bun run safari:status.
Livelli di permesso#
Decidi tu quanta autonomia ha l’agente, per ciascun server, con bun run safari:config:
| Livello | Cosa significa |
|---|---|
confirm (predefinito) | Ogni clic con effetti esterni (votare, inviare, pubblicare, acquistare…) ti chiede prima conferma |
autonomous | Voti, follow e invii vengono eseguiti senza chiedere; pagamenti, eliminazioni permanenti e modifiche all’account o alla sicurezza chiedono comunque conferma |
readonly | Solo navigare, ispezionare e catturare — cliccare e digitare sono disabilitati |
Cosa può fare l’agente#
- Aprire, navigare e chiudere schede
- Ispezionare una pagina: controlli visibili con selettori stabili, stato e attributi semantici
- Trovare controlli tramite il loro testo visibile o gli attributi identificativi
- Cliccare e compilare moduli (consapevole dei framework, con verifica prima/dopo)
- Scorrere e catturare screenshot, restituiti nella tua chat
Ogni azione riporta cosa è successo davvero — incluso se un clic ha cambiato realmente qualcosa — così l’agente verifica invece di tirare a indovinare.
Modello di sicurezza#
- Solo loopback — l’estensione si connette esclusivamente agli indirizzi locali che configuri tu.
- Codici di abbinamento monouso — i codici scadono dopo 5 minuti e valgono una sola volta; la credenziale risultante non lascia mai il tuo Mac.
- Scadenza dei comandi — i comandi che l’estensione non preleva entro 20 secondi vengono scartati, quindi nulla viene eseguito in ritardo.
- Le chiavi le tieni tu — pagamenti e azioni distruttive richiedono sempre la tua conferma esplicita, a ogni livello di permesso che consente il clic.
- Verificabile — il JavaScript dell’estensione è distribuito leggibile dentro il bundle dell’app.
Download#
L’estensione è inclusa nell’Agent Server (assets/safari/PocketHook-Safari.zip), oppure scaricala direttamente: PocketHook-Safari.zip — firmata e notarizzata per macOS.