O que é a extensão Safari do PocketHook?#
Uma extensão do Safari para macOS que permite ao seu Agent Server auto-hospedado trabalhar dentro do seu navegador de verdade: abrir e fechar abas, ler páginas, encontrar e clicar em controles, preencher formulários e capturar telas — na sua sessão, com seus logins, na sua máquina.
Tudo roda localmente. A extensão só conversa com o Agent Server no seu próprio Mac (loopback), e nada é enviado para nenhum outro lugar.
Instalação#
A extensão vem junto com o Agent Server como um app macOS notarizado — sem App Store, sem Xcode:
bun run safari:install
Isso instala o Pockethook Safari.app em /Applications e o abre. Depois, no Safari:
- Ajustes → Extensões — ative PocketHook Safari e conceda acesso aos sites.
- Gere um código de pareamento de uso único no servidor:
bun run safari:code
- Abra o popup da extensão na barra de ferramentas do Safari, digite o código e pressione Pair. Um ponto verde significa que você está conectado.
Verifique a conexão a qualquer momento com bun run safari:status.
Níveis de permissão#
Você decide quanta autonomia o agente recebe, por servidor, com bun run safari:config:
| Nível | O que significa |
|---|---|
confirm (padrão) | Cada clique com efeitos externos (votar, enviar, publicar, comprar…) pede sua confirmação primeiro |
autonomous | Votos, follows e envios rodam sem perguntar; pagamentos, exclusões permanentes e mudanças de conta ou segurança continuam pedindo |
readonly | Apenas navegar, inspecionar e capturar — clicar e digitar ficam desabilitados |
O que o agente pode fazer#
- Abrir, navegar e fechar abas
- Inspecionar uma página: controles visíveis com seletores estáveis, estado e atributos semânticos
- Encontrar controles pelo texto visível ou por atributos identificadores
- Clicar e preencher formulários (com suporte a frameworks, com verificação antes/depois)
- Rolar e capturar telas, entregues de volta no seu chat
Cada ação reporta o que realmente aconteceu — inclusive se um clique de fato mudou alguma coisa — para que o agente verifique em vez de adivinhar.
Modelo de segurança#
- Somente loopback — a extensão se conecta exclusivamente a endereços locais que você configura.
- Códigos de pareamento de uso único — os códigos expiram após 5 minutos e valem uma única vez; a credencial resultante nunca sai do seu Mac.
- Expiração de comandos — comandos que a extensão não pegou em 20 segundos são descartados, então nada executa atrasado.
- As chaves ficam com você — pagamentos e ações destrutivas sempre exigem sua confirmação explícita, em todos os níveis de permissão que permitem clicar.
- Auditável — o JavaScript da extensão é distribuído legível dentro do bundle do app.
Download#
A extensão vem junto com o Agent Server (assets/safari/PocketHook-Safari.zip), ou baixe diretamente: PocketHook-Safari.zip — assinada e notarizada para macOS.