Apa itu Ekstensi Safari PocketHook?#
Ekstensi Safari untuk macOS yang memungkinkan Agent Server self-hosted Anda bekerja di dalam browser asli Anda: membuka dan menutup tab, membaca halaman, menemukan dan mengklik kontrol, mengisi formulir, dan mengambil tangkapan layar — di sesi Anda, dengan login Anda, di mesin Anda.
Semuanya berjalan secara lokal. Ekstensi hanya berkomunikasi dengan Agent Server di Mac Anda sendiri (loopback), dan tidak ada yang dikirim ke tempat lain.
Instalasi#
Ekstensi disertakan bersama Agent Server sebagai aplikasi macOS yang sudah dinotarisasi — tanpa App Store, tanpa Xcode:
bun run safari:install
Perintah ini menginstal Pockethook Safari.app ke /Applications dan menjalankannya. Kemudian, di Safari:
- Pengaturan → Ekstensi — aktifkan PocketHook Safari dan berikan akses situs web.
- Buat kode pairing sekali pakai di server:
bun run safari:code
- Buka popup ekstensi di toolbar Safari, masukkan kodenya, lalu tekan Pair. Titik hijau berarti Anda sudah terhubung.
Periksa koneksi kapan saja dengan bun run safari:status.
Tingkat izin#
Anda yang menentukan seberapa besar otonomi agent, per server, dengan bun run safari:config:
| Tingkat | Artinya |
|---|---|
confirm (default) | Setiap klik dengan efek eksternal (vote, submit, publikasi, pembelian…) meminta persetujuan Anda terlebih dahulu |
autonomous | Vote, follow, dan submit berjalan tanpa bertanya; pembayaran, penghapusan permanen, serta perubahan akun atau keamanan tetap meminta persetujuan |
readonly | Hanya navigasi, inspeksi, dan tangkapan layar — mengklik dan mengetik dinonaktifkan |
Apa yang bisa dilakukan agent#
- Membuka, menavigasi, dan menutup tab
- Menginspeksi halaman: kontrol yang terlihat dengan selector stabil, status, dan atribut semantik
- Menemukan kontrol berdasarkan teks yang terlihat atau atribut pengenalnya
- Mengklik dan mengisi formulir (sadar framework, dengan verifikasi sebelum/sesudah)
- Menggulir dan mengambil tangkapan layar, yang dikirim kembali ke chat Anda
Setiap aksi melaporkan apa yang benar-benar terjadi — termasuk apakah sebuah klik benar-benar mengubah sesuatu — sehingga agent memverifikasi alih-alih menebak.
Model keamanan#
- Hanya loopback — ekstensi terhubung secara eksklusif ke alamat lokal yang Anda konfigurasikan.
- Kode pairing sekali pakai — kode kedaluwarsa setelah 5 menit dan hanya berlaku satu kali; kredensial yang dihasilkan tidak pernah meninggalkan Mac Anda.
- Kedaluwarsa perintah — perintah yang tidak diambil ekstensi dalam 20 detik akan dibuang, jadi tidak ada yang dieksekusi terlambat.
- Kunci ada di tangan Anda — pembayaran dan aksi destruktif selalu memerlukan konfirmasi eksplisit dari Anda, di setiap tingkat izin yang mengizinkan klik.
- Dapat diaudit — JavaScript ekstensi disertakan dalam bentuk yang dapat dibaca di dalam bundel aplikasi.
Unduhan#
Ekstensi dibundel bersama Agent Server (assets/safari/PocketHook-Safari.zip), atau unduh langsung: PocketHook-Safari.zip — ditandatangani dan dinotarisasi untuk macOS.