Peekaboo is a macOS CLI and optional MCP server for screen capture and UI automation, with integrated agent workflows and MCP client support. It targets macOS 15+ and Swift 6.2, and provides CLI, app, and npm-based MCP launcher.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Peekaboo is a macOS CLI and menu-bar app for screen capture, accessibility inspection, and native UI automation. It can run directly, operate an agent, or be exposed to MCP clients. The project provides a CLI, a Mac app, and an MCP launcher via npm.
How it works
The tool observes the screen, identifies UI elements, and can interact with them (click, type, etc.). It offers an agent command to execute natural-language driven workflows and an MCP integration to connect with other clients.
Getting started
Install options include:
brew install steipete/tap/peekaboo
npx -y @steipete/peekaboo --version
The Mac app is downloaded from the latest GitHub release. See installation guide for source builds and alternative install details.
Quick start examples:
peekaboo permissions status
peekaboo image --mode screen --path /tmp/peekaboo-screen.png
peekaboo see --app Finder --json
peekaboo click "Address and search bar" --app Safari
peekaboo type "github.com/openclaw/Peekaboo" --app Safari --return
peekaboo agent "Open Safari, go to github.com, and search for Peekaboo"
Getting started (continued)
Configuration and credentials are stored under ~/.peekaboo. Use peekaboo config to inspect or change them. Shell completions are available via peekaboo completions.
Recent releases
Latest releases include:
- v3.9.10 (2026-08-02) with readme rewrite and payload reissue
- v3.9.9 (2026-08-02)
- v3.9.8 (2026-07-23) with fixes for MCP I/O deadlocks
- v3.9.7 (2026-07-21)
- v3.9.6 (2026-07-19) signing migration completion
Traction
Stars: 4961, Forks: 384, Open issues: 4
Caveats
License: MIT. Requires macOS 15+ and Swift 6.2+. Development notes reference Node.js 22+ for MCP and various tooling in docs.






