Vad är PocketHooks Safari-tillägg?#
Ett Safari-tillägg för macOS som låter din självhostade Agent Server arbeta inuti din riktiga webbläsare: öppna och stänga flikar, läsa sidor, hitta och klicka på kontroller, fylla i formulär och ta skärmdumpar — i din session, med dina inloggningar, på din maskin.
Allt körs lokalt. Tillägget pratar bara med Agent Server på din egen Mac (loopback), och ingenting skickas någon annanstans.
Installera#
Tillägget levereras med Agent Server som en notariserad macOS-app — ingen App Store, ingen Xcode:
bun run safari:install
Detta installerar Pockethook Safari.app i /Applications och startar den. Sedan, i Safari:
- Inställningar → Tillägg — aktivera PocketHook Safari och ge åtkomst till webbplatser.
- Generera en parkopplingskod för engångsbruk på servern:
bun run safari:code
- Öppna tilläggets popup i Safaris verktygsfält, ange koden och tryck på Pair. En grön prick betyder att du är ansluten.
Kontrollera anslutningen när som helst med bun run safari:status.
Behörighetsnivåer#
Du bestämmer hur mycket autonomi agenten får, per server, med bun run safari:config:
| Nivå | Vad den innebär |
|---|---|
confirm (standard) | Varje klick med externa effekter (rösta, skicka, publicera, köpa…) frågar dig först |
autonomous | Röster, följningar och inskickningar körs utan att fråga; betalningar, permanenta raderingar och konto- eller säkerhetsändringar frågar fortfarande |
readonly | Endast navigera, inspektera och fånga — att klicka och skriva är inaktiverat |
Vad agenten kan göra#
- Öppna, navigera och stänga flikar
- Inspektera en sida: synliga kontroller med stabila selektorer, tillstånd och semantiska attribut
- Hitta kontroller via deras synliga text eller identifierande attribut
- Klicka och fylla i formulär (ramverksmedvetet, med verifiering före/efter)
- Skrolla och ta skärmdumpar som levereras tillbaka till din chatt
Varje åtgärd rapporterar vad som faktiskt hände — inklusive om ett klick verkligen ändrade något — så att agenten verifierar istället för att gissa.
Säkerhetsmodell#
- Endast loopback — tillägget ansluter uteslutande till lokala adresser som du konfigurerar.
- Parkopplingskoder för engångsbruk — koderna upphör efter 5 minuter och gäller bara en gång; den resulterande behörighetsnyckeln lämnar aldrig din Mac.
- Kommandon förfaller — kommandon som tillägget inte hämtat inom 20 sekunder kasseras, så inget körs för sent.
- Du håller i nycklarna — betalningar och destruktiva åtgärder kräver alltid din uttryckliga bekräftelse, på varje behörighetsnivå som tillåter klick.
- Granskningsbart — tilläggets JavaScript levereras läsbart inuti appens paket.
Ladda ner#
Tillägget medföljer Agent Server (assets/safari/PocketHook-Safari.zip), eller hämta det direkt: PocketHook-Safari.zip — signerat och notariserat för macOS.