Automate macOS UI interactions to inspect, control, and test apps.
npx skills add https://github.com/AG064/argentum --skill peekaboo-ag064
Please help me install this Agent Skill. Skill: peekaboo Source: https://github.com/AG064/argentum/tree/main/skills/peekaboo Command: npx skills add https://github.com/AG064/argentum --skill peekaboo-ag064
Automates macOS UI interactions to inspect, control, and automate tasks across apps.
bridge: inspect Peekaboo Bridge host connectivitycapture: live capture or video ingest + frame extractionclean: prune snapshot cache and temp filesconfig: init/show/edit/validate, providers, models, credentialsimage: capture screenshots (screen/window/menu bar regions)learn: print the full agent guide + tool cataloglist: apps, windows, screens, menubar, permissionspermissions: check Screen Recording/Accessibility statusrun: execute .peekaboo.json scriptssleep: pause execution for a durationtools: list available tools with filtering/display optionsInteraction
click: target by ID/query/coords with smart waitsdrag: drag & drop across elements/coords/Dockhotkey: modifier combos like cmd,shift,tmove: cursor positioning with optional smoothingpaste: set clipboard -> paste -> restorepress: special-key sequences with repeatsscroll: directional scrolling (targeted + smooth)swipe: gesture-style drags between targetstype: text + control keys (--clear, delays)System
app: launch/quit/relaunch/hide/unhide/switch/list appsclipboard: read/write clipboard (text/images/files)dialog: click/input/file/dismiss/list system dialogsdock: launch/right-click/hide/show/list Dock itemsmenu: click/list application menus + menu extrasmenubar: list/click status bar itemsopen: enhanced open with app targeting + JSON payloadsspace: list/switch/move-window (Spaces)visualizer: exercise Peekaboo visual feedback animationswindow: close/minimize/maximize/move/resize/focus/listVision
see: annotated UI maps, snapshot IDs, optional analysisGlobal runtime flags
--json/-j, --verbose/-v, --log-level <level>--no-remote, --bridge-socket <path>Install Peekaboo and run a basic command to capture a screenshot of the active application.
High-intent search queries and answers about installing and using this skill.
You can automate macOS UI interactions by executing CLI commands to click, type, drag, and press hotkeys. This Skill targets elements by ID, query, or coordinates with smart waits, enabling full control across native applications.
Yes, you can capture screenshots of screens, windows, or menu bar regions and extract frames from video ingests using CLI commands. It also provides annotated UI maps and snapshot IDs for optional visual analysis.
Yes, you need Screen Recording and Accessibility permissions on your macOS environment for full control. You can use a built-in permissions command to check the status of these system privileges before running automation scripts.
The best way to script routine macOS workflows is by executing `.peekaboo.json` scripts. These scripts orchestrate app launching, window management, menu navigation, and text entry to automate repetitive tasks across applications.
macOS UI automation handles system dialogs by clicking, inputting text, or dismissing them programmatically. It also reads and writes clipboard contents including text, images, and files, restoring the original clipboard after pasting.
macOS automation scripts fail to interact with application menus without Screen Recording and Accessibility permissions. You must verify system permissions and ensure the target application is running before executing menu click or list commands.
Zentin-LAutomate macOS UI tasks by capturing screens, targeting elements, and driving input via CLI.
bettercallfanDetect sustained occupancy or anomalies in video frames using timestamp analysis.
exalandManage n8n workflows, credentials, and executions via the CLI.
cacr92Develop macOS Platform Agents with Swift and the Accessibility API.