PocketHook Safari拡張機能とは？#
セルフホストのAgent Serverが実際のブラウザの中で作業できるようにするmacOS用Safari拡張機能です：タブの開閉、ページの読み取り、コントロールの検索とクリック、フォーム入力、スクリーンショット撮影 — あなたのセッションで、あなたのログイン情報のまま、あなたのマシン上で。
すべてローカルで動作します。拡張機能はあなた自身のMac上のAgent Serverとだけ通信し（ループバック）、他のどこにも何も送信されません。
インストール#
拡張機能は、公証済みmacOSアプリとしてAgent Serverに同梱されています — App StoreもXcodeも不要：
bun run safari:install
これでPockethook Safari.appが/Applicationsにインストールされ、起動します。その後、Safariで：
- 設定 → 機能拡張 — PocketHook Safariを有効にし、Webサイトへのアクセスを許可します。
- サーバーでワンタイムペアリングコードを生成します：
bun run safari:code
- Safariのツールバーで拡張機能のポップアップを開き、コードを入力してPairを押します。緑のドットが表示されれば接続完了です。
接続状態はbun run safari:statusでいつでも確認できます。
パーミッションレベル#
エージェントにどれだけの自律性を与えるかは、サーバーごとにbun run safari:configで決められます：
| レベル | 意味 |
|---|---|
confirm （デフォルト） | 外部に影響するクリック（投票、送信、公開、購入など）は毎回あなたに確認します |
autonomous | 投票、フォロー、送信は確認なしで実行。支払い、恒久的な削除、アカウントやセキュリティの変更は引き続き確認します |
readonly | ナビゲーション、検査、キャプチャのみ — クリックと入力は無効 |
エージェントができること#
- タブを開く、移動する、閉じる
- ページの検査：安定したセレクター、状態、セマンティック属性を持つ可視コントロール
- 可視テキストや識別属性によるコントロールの検索
- クリックとフォーム入力（フレームワーク対応、前後の検証付き）
- スクロールとスクリーンショット撮影、結果はチャットに返送
各アクションは実際に何が起きたかを報告します — クリックが本当に何かを変えたかどうかも含めて — そのため、エージェントは推測する代わりに検証します。
セキュリティモデル#
- ループバックのみ — 拡張機能は、あなたが設定したローカルアドレスにのみ接続します。
- ワンタイムペアリングコード — コードは5分で失効し、1回限り有効。生成された認証情報があなたのMacの外に出ることはありません。
- コマンドの有効期限 — 拡張機能が20秒以内に取得しなかったコマンドは破棄されるため、遅れて実行されることはありません。
- 鍵を握るのはあなた — 支払いと破壊的なアクションは、クリックを許可するすべてのパーミッションレベルで、常にあなたの明示的な確認を必要とします。
- 監査可能 — 拡張機能のJavaScriptは、アプリバンドル内に読める形で同梱されています。
ダウンロード#
拡張機能はAgent Serverに同梱されています（assets/safari/PocketHook-Safari.zip）。直接入手も可能：PocketHook-Safari.zip — macOS向けに署名・公証済み。