Peekaboo

安装配置

npx -y @steipete/peekaboo

README 摘要

# Peekaboo 🫣 - Mac automation that sees the screen and does the clicks.  [](https://www.npmjs.com/package/@steipete/peekaboo) [](https://opensource.org/licenses/MIT) [-0078d7?logo=apple&logoColor=white&style=flat-square)](https://www.apple.com/macos/) [](https://swift.org/) [](https://nodejs.org/) [](https://github.com/steipete/peekaboo/releases/latest) [](https://github.com/steipete/homebrew-tap) [](https://deepwiki.com/steipete/peekaboo) 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 synthetic input fallback for apps that need it. - 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. - MCP server for Codex, Claude Code, and Cursor plus a native CLI; the same tools in both. - Configurable, testable workflows with reproducible sessions and strict typing. - Requires macOS Screen Recording + Accessibility permissions (see [docs/permissions.md](docs/permissions.md)). ## Install - macOS app + CLI (Homebrew): ```bash brew install steipete/tap/peekaboo ``` - MCP server (Node 22+, no global install needed): ```bash npx -y @steipete/peekaboo ``` ## Quick start ```bash # Capture full screen at Retina scale and save to Desktop peekaboo image --mode screen --retina --path ~/Desktop/screen.png # Click a button by label (captures, resolves, and clicks in one go) peekaboo see --app Safari --json | jq -r '.data.snapshot_id' | read SNAPSHOT peekaboo click --on "Reload this page" --snapshot "$SNAPSHOT" # Directly set a text field value when the accessibility value is settable peekaboo set-value --on T1 --value "hello" --snapshot "$SNAPSHOT" # Invoke a named accessibility action on an element peekaboo perform-action --on B1 --action AXPress --snapshot "$SNAPSHOT" # Run a natural-language automation peekaboo agent "Open Notes and create a TODO list with three items" # Run as an MCP server (Codex, Claude Code, Cursor) npx -y @steipete/peekaboo # Minimal MCP client config snippet: # { # "mcpServers": { # "peekaboo": { # "command": "npx", #...