peekabooCapture and automate macOS UI with the Peekaboo CLI.
Install via ClawdBot CLI:
clawdbot install steipete/peekabooInstall Peekaboo (brew):
brew install steipete/tap/peekabooRequires:
Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI
elements, drive input, and manage apps/windows/menus. Commands share a snapshot
cache and support --json/-j for scripting. Run peekaboo or
peekaboo for flags; peekaboo --version prints build metadata.
Tip: run via polter peekaboo to ensure fresh builds.
Core
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 --no-remote, --bridge-socket peekaboo permissions
peekaboo list apps --json
peekaboo see --annotate --path /tmp/peekaboo-see.png
peekaboo click --on B1
peekaboo type "Hello" --return--app, --pid, --window-title, --window-id, --window-index--snapshot (ID from see; defaults to latest)--on/--id (element ID), --coords x,y--no-auto-focus, --space-switch, --bring-to-current-space, --focus-timeout-seconds, --focus-retry-count
--path, --format png|jpg, --retina--mode screen|window|frontmost, --screen-index, --window-title, --window-id
--analyze "prompt", --annotate--capture-engine auto|classic|cg|modern|sckit--duration (drag/swipe), --steps, --delay (type/scroll/press)--profile human|linear, --wpm (typing)--direction up|down|left|right, --amount , --smoothpeekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
peekaboo click --on B3 --app Safari
peekaboo type "user@example.com" --app Safari
peekaboo press tab --count 1 --app Safari
peekaboo type "supersecret" --app Safari --returnpeekaboo list windows --app "Visual Studio Code" --json
peekaboo click --window-id 12345 --coords 120,160
peekaboo type "Hello from Peekaboo" --window-id 12345peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
peekaboo image --app Safari --window-title "Dashboard" --analyze "Summarize KPIs"
peekaboo see --mode screen --screen-index 0 --analyze "Summarize the dashboard"peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \
--active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capturepeekaboo app launch "Safari" --open https://example.com
peekaboo window focus --app Safari --window-title "Example"
peekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800
peekaboo app quit --app Safaripeekaboo menu click --app Safari --item "New Window"
peekaboo menu click --app TextEdit --path "Format > Font > Show Fonts"
peekaboo menu click-extra --title "WiFi"
peekaboo dock launch Safari
peekaboo menubar list --jsonpeekaboo move 500,300 --smooth
peekaboo drag --from B1 --to T2
peekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800
peekaboo scroll --direction down --amount 6 --smoothpeekaboo hotkey --keys "cmd,shift,t"
peekaboo press escape
peekaboo type "Line 1\nLine 2" --delay 10Notes
peekaboo see --annotate to identify targets before clicking.Generated Feb 16, 2026
Developers can use Peekaboo to automate UI testing by capturing screenshots, clicking elements, and typing text to simulate user interactions. This ensures app functionality across updates without manual testing, integrating into CI/CD pipelines via JSON output for scripting.
Organizations can automate accessibility audits by using Peekaboo to capture UI elements and analyze them for compliance with standards like WCAG. This helps identify issues in macOS apps quickly, reducing manual effort and improving inclusivity.
IT teams can automate common support tasks such as configuring system settings, managing applications, and handling dialogs on macOS devices. Peekaboo's ability to interact with menus and windows streamlines remote troubleshooting and deployment processes.
Businesses can automate repetitive data entry tasks by using Peekaboo to type text, click buttons, and navigate forms in macOS applications. This increases efficiency and reduces errors in workflows like CRM updates or inventory management.
Content creators can use Peekaboo to capture high-quality screenshots and videos of macOS UI for tutorials or demos. Features like live capture with motion highlighting and annotation support enhance visual storytelling and training materials.
Offer Peekaboo as a cloud-based service with additional features like analytics dashboards and team collaboration tools. Charge monthly or annual subscriptions based on usage tiers, targeting businesses needing scalable macOS automation solutions.
Provide consulting services to help clients integrate Peekaboo into their workflows, offering custom scripting, training, and support. This model leverages expertise in automation to solve specific business problems, generating project-based revenue.
Distribute Peekaboo as a free CLI tool to build a user base, then monetize through premium add-ons like advanced AI analysis, priority support, or enterprise-grade security features. This encourages adoption while upselling to power users.
💬 Integration Tip
Integrate Peekaboo into existing workflows by using its JSON output for scripting and combining with tools like cron jobs or CI/CD pipelines to automate repetitive tasks efficiently.
Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Clawdbot to add a note, list notes, search notes, or manage note folders.
Speak responses aloud on macOS using the built-in `say` command when user input indicates Voice Wake/voice recognition (for example, messages starting with "User talked via voice recognition on <device>").
Homebrew package manager for macOS. Search, install, manage, and troubleshoot packages and casks.
Automate macOS desktop by capturing screenshots and executing precise mouse movements, clicks, and keyboard inputs via cliclick.
Control Apple TV, HomePod, and AirPlay devices via pyatv (scan, stream, playback, volume, navigation).