steipete/peekaboo

Peekaboo 🫣 - Mac automation that sees the screen and does the clicks.

Peekaboo brings high-fidelity screen capture, AI analysis, and complete GUI automation to macOS. Version 3 adds native agent flows and multi-screen automation across the CLI and MCP server.

What you get

• Pixel-accurate captures (windows, screens, menu bar) with optional Retina 2x scaling.
• Natural-language agent that chains Peekaboo tools (see, click, type, scroll, hotkey, menu, window, app, dock, space).
• Action-first UI automation for routine clicks/scrolls, with background process-targeted input by default when a target is known.
• Direct accessibility tools for settable values and named actions (set-value, perform-action).
• Menu and menubar discovery with structured JSON; no clicks required.
• Multi-provider AI through Tachikoma, including hosted, local, and OpenAI-/Anthropic-compatible providers.
• Claude Fable 5 support with 1M context and a 128K output ceiling; saved temperature/max-token settings are shared by the app and CLI and clamped to each model's capabilities.
• MCP server for Codex, Claude Code, and Cursor plus a native CLI; the same tools in both.
• Warm daemon and Peekaboo.app Bridge hosts for permission-bound automation, with distinct lease-owned sockets and local fallback.
• Configurable, testable workflows with reproducible sessions and strict typing.
• Requires macOS Screen Recording + Accessibility permissions (see docs/permissions.md).