Hva er PocketHook Safari-utvidelsen?#
En Safari-utvidelse for macOS som lar din selvhostede Agent Server jobbe inne i din virkelige nettleser: åpne og lukke faner, lese sider, finne og klikke på kontroller, fylle ut skjemaer og ta skjermbilder — i din sesjon, med dine pålogginger, på din maskin.
Alt kjører lokalt. Utvidelsen snakker bare med Agent Server på din egen Mac (loopback), og ingenting sendes noe annet sted.
Installasjon#
Utvidelsen leveres sammen med Agent Server som en notarisert macOS-app — ingen App Store, ingen Xcode:
bun run safari:install
Dette installerer Pockethook Safari.app i /Applications og starter den. Deretter, i Safari:
- Innstillinger → Utvidelser — aktiver PocketHook Safari og gi tilgang til nettsteder.
- Generer en engangs sammenkoblingskode på serveren:
bun run safari:code
- Åpne utvidelsens popup i Safari-verktøylinjen, skriv inn koden og trykk Pair. En grønn prikk betyr at du er tilkoblet.
Sjekk tilkoblingen når som helst med bun run safari:status.
Tillatelsesnivåer#
Du bestemmer hvor mye autonomi agenten får, per server, med bun run safari:config:
| Nivå | Hva det betyr |
|---|---|
confirm (standard) | Hvert klikk med eksterne effekter (stemme, sende inn, publisere, kjøpe…) spør deg først |
autonomous | Stemmer, følginger og innsendinger kjøres uten å spørre; betalinger, permanente slettinger og konto- eller sikkerhetsendringer spør fortsatt |
readonly | Kun navigering, inspeksjon og skjermbilder — klikking og skriving er deaktivert |
Hva agenten kan gjøre#
- Åpne, navigere og lukke faner
- Inspisere en side: synlige kontroller med stabile selektorer, tilstand og semantiske attributter
- Finne kontroller via synlig tekst eller identifiserende attributter
- Klikke og fylle ut skjemaer (rammeverksbevisst, med for/etter-verifisering)
- Rulle og ta skjermbilder, som leveres tilbake til chatten din
Hver handling rapporterer hva som faktisk skjedde — inkludert om et klikk virkelig endret noe — så agenten verifiserer i stedet for å gjette.
Sikkerhetsmodell#
- Kun loopback — utvidelsen kobler seg utelukkende til lokale adresser du konfigurerer.
- Engangs sammenkoblingskoder — koder utløper etter 5 minutter og kan bare brukes en gang; den resulterende legitimasjonen forlater aldri Mac-en din.
- Kommandoutløp — kommandoer utvidelsen ikke hentet innen 20 sekunder forkastes, så ingenting kjøres for sent.
- Du sitter på nøklene — betalinger og destruktive handlinger krever alltid din eksplisitte bekreftelse, på hvert tillatelsesnivå som tillater klikking.
- Reviderbar — utvidelsens JavaScript leveres lesbar inne i app-bundelen.
Nedlasting#
Utvidelsen er inkludert med Agent Server (assets/safari/PocketHook-Safari.zip), eller hent den direkte: PocketHook-Safari.zip — signert og notarisert for macOS.