C’est quoi l’extension Safari de PocketHook ?#
Une extension Safari pour macOS qui permet à votre Agent Server auto-hébergé de travailler directement 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 roule en local. L’extension parle seulement à l’Agent Server sur votre propre Mac (loopback), et rien n’est envoyé ailleurs.
Installation#
L’extension vient avec l’Agent Server comme app macOS notariée — pas d’App Store, pas de Xcode :
bun run safari:install
Ça installe Pockethook Safari.app dans /Applications et ça la lance. Ensuite, dans Safari :
- Réglages → Extensions — activez PocketHook Safari et accordez l’accès aux sites web.
- Générez un code de jumelage à usage unique sur le serveur :
bun run safari:code
- Ouvrez le popup de l’extension dans la barre d’outils de Safari, entrez le code et appuyez sur Pair. Un point vert veut dire que vous êtes connecté.
Vérifiez la connexion n’importe quand avec bun run safari:status.
Niveaux de permission#
C’est vous qui décidez combien d’autonomie l’agent reçoit, par serveur, avec bun run safari:config :
| Niveau | Ce que ça veut dire |
|---|---|
confirm (par défaut) | Chaque clic avec des effets externes (voter, soumettre, publier, acheter…) vous demande la permission d’abord |
autonomous | Les votes, les abonnements et les soumissions roulent sans demander ; les paiements, les suppressions permanentes et les changements de compte ou de sécurité demandent encore |
readonly | Naviguer, inspecter et capturer seulement — cliquer et taper 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)
- Défiler et capturer des écrans, retournés dans votre chat
Chaque action rapporte ce qui s’est vraiment passé — incluant si un clic a réellement changé quelque chose — fait que l’agent vérifie au lieu de deviner.
Modèle de sécurité#
- Loopback seulement — l’extension se connecte exclusivement aux adresses locales que vous configurez.
- Codes de jumelage à usage unique — les codes expirent après 5 minutes et servent une seule fois ; l’identifiant qui en résulte quitte jamais votre Mac.
- Expiration des commandes — les commandes que l’extension a pas ramassées en dedans de 20 secondes sont jetées, donc rien 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 permettent de cliquer.
- Auditable — le JavaScript de l’extension est livré lisible dans le bundle de l’app.
Téléchargement#
L’extension vient 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.