peekaboo

Peekaboo 是一款專為進階 UI 自動化與桌面環境管理而設計的 macOS CLI 工具。對於需要以程式方式與圖形使用者介面互動、自動化重複性手動任務或從系統擷取視覺資料的開發者與進階使用者而言，這是不可或缺的工具組。透過連接 CLI 指令與 macOS Accessibility API，Peekaboo 實現了對應用程式、視窗、選單及系統對話框的無縫控制，無需手動介入。

• 完整的 UI 生命週期管理，包含應用程式啟動、聚焦、調整大小、移動及應用程式狀態控制。

• 進階擷取功能，支援螢幕、視窗與選單列區域，包含即時視訊擷取與影格擷取。

• 強大的互動套件，提供精確的滑鼠移動、拖放操作、手勢及可自訂延遲與配置的智慧鍵盤輸入。

• 直接整合 macOS 無障礙服務與系統選單，包含 Dock 項目、選單列工具與全域快捷鍵。

• 支援使用 .peekaboo.json 檔案的 JSON 原生腳本，允許定義複雜工作流程，並透過 --json 輸出以進行管道傳輸。

• 基於快照的目標系統，使用識別碼來追蹤 UI 元素，並結合智慧等待邏輯，提升在不穩定 UI 環境下的執行可靠性。

• 使用者必須在系統設定中授予「螢幕錄製」與「輔助使用」權限，工具才能正常運作。

• 強烈建議在建構自動化腳本前，使用 see --annotate 指令來檢查識別碼並映射目標 UI 元素。

• 此工具設計為可作為獨立 CLI 或整合至代理工作流程中，例如 OpenClaw 助理生態系統。

• 支援多種擷取引擎，如 classic、cg、modern 與 ScreenCaptureKit，適用於不同 macOS 版本與安全性環境。

• 透過快照快取優化效能與可靠性，並可使用 clean 指令清除暫存檔案。