Qu’est-ce que l’extension Safari de PocketHook ?#
Une extension Safari pour macOS qui permet à votre Agent Server auto-hébergé de travailler dans votre vrai navigateur : ouvrir et fermer des onglets, lire des pages, trouver et cliquer des contrôles, remplir des formulaires et capturer des écrans — dans votre session, avec vos connexions, sur votre machine.
Tout fonctionne en local. L’extension ne parle qu’à l’Agent Server sur votre propre Mac (loopback), et rien n’est envoyé ailleurs.
Installation#
L’extension est livrée avec l’Agent Server sous forme d’app macOS notariée — pas d’App Store, pas de Xcode :
bun run safari:install
Cela installe Pockethook Safari.app dans /Applications et la lance. Ensuite, dans Safari :
- Réglages → Extensions — activez PocketHook Safari et accordez l’accès aux sites web.
- Générez un code d’appairage à usage unique sur le serveur :
bun run safari:code
- Ouvrez le popup de l’extension dans la barre d’outils de Safari, saisissez le code et appuyez sur Pair. Un point vert signifie que vous êtes connecté.
Vérifiez la connexion à tout moment avec bun run safari:status.
Niveaux de permission#
Vous décidez du degré d’autonomie de l’agent, par serveur, avec bun run safari:config :
| Niveau | Ce que cela signifie |
|---|---|
confirm (par défaut) | Chaque clic avec des effets externes (voter, envoyer, publier, acheter…) vous demande d’abord confirmation |
autonomous | Les votes, les abonnements et les envois s’exécutent sans demander ; les paiements, les suppressions définitives et les changements de compte ou de sécurité demandent toujours |
readonly | Naviguer, inspecter et capturer uniquement — cliquer et saisir sont désactivés |
Ce que l’agent peut faire#
- Ouvrir, parcourir et fermer des onglets
- Inspecter une page : contrôles visibles avec sélecteurs stables, état et attributs sémantiques
- Trouver des contrôles par leur texte visible ou leurs attributs identifiants
- Cliquer et remplir des formulaires (compatible avec les frameworks, avec vérification avant/après)
- Faire défiler et capturer des écrans, renvoyés dans votre chat
Chaque action rapporte ce qui s’est réellement passé — y compris si un clic a vraiment changé quelque chose — de sorte que l’agent vérifie au lieu de deviner.
Modèle de sécurité#
- Loopback uniquement — l’extension se connecte exclusivement aux adresses locales que vous configurez.
- Codes d’appairage à usage unique — les codes expirent après 5 minutes et ne servent qu’une seule fois ; l’identifiant résultant ne quitte jamais votre Mac.
- Expiration des commandes — les commandes que l’extension n’a pas récupérées dans les 20 secondes sont rejetées, donc rien ne s’exécute en retard.
- C’est vous qui gardez les clés — les paiements et les actions destructrices exigent toujours votre confirmation explicite, à tous les niveaux de permission qui autorisent le clic.
- Auditable — le JavaScript de l’extension est livré lisible dans le bundle de l’app.
Téléchargement#
L’extension est incluse avec l’Agent Server (assets/safari/PocketHook-Safari.zip), ou téléchargez-la directement : PocketHook-Safari.zip — signée et notariée pour macOS.