peekaboo

Use when automating macOS GUI — screenshots, screen capture, clicking elements, typing text, managing windows/menus/apps/spaces, MCP server integration, or building AI desktop agents with Peekaboo.

Model	Source
inherit	pack: macos-automation

Full Reference

Peekaboo

Mandatory Announcement — FIRST OUTPUT before anything else:

┏━ 🔧 peekaboo ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ [one-line description of what you're automating] ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Swift-native macOS GUI automation platform. 35+ CLI commands for screenshot capture, element interaction, window/app/menu management, and AI agent mode. Version 3.0.0-beta4, macOS 15.0+ arm64 only.

Quick Reference

Item	Value
Version	3.0.0-beta4
Install	`brew install steipete/tap/peekaboo`
Alt Install	`npx -y @steipete/peekaboo`
Config	`~/.peekaboo/config.json`
Credentials	`~/.peekaboo/credentials` (chmod 600)
Docs	https://peekaboo.boo
Fork	https://github.com/Armadillo-Nation/armadillo-mac-peek
Requirements	macOS 15.0+ Sequoia, arm64 (Apple Silicon) only

Reference Index

I want to…	File
Take screenshots, capture screen, see UI elements, list apps/windows	`reference/capture.md`
Click, type, press keys, scroll, swipe, drag, paste	`reference/interaction.md`
Manage windows, apps, menus, dock, dialogs, spaces	`reference/system.md`
Use AI agent mode, NL automation, multi-model	`reference/agent.md`
Set up MCP server, tool filtering, bridge, daemon	`reference/mcp.md`
Install, grant permissions, configure providers	`reference/setup.md`
Clipboard ops, clean snapshots, run scripts, tools	`reference/utilities.md`

Load only the reference docs relevant to the current task. Don’t ingest all files for a single question.