Peekaboo 是一个 macOS 的 CLI 和可选的 MCP 服务器，使 AI 代理能够截取应用程序或整个系统的截图，并可选择通过本地或远程 AI 进行视觉问题解答......
概览
Peekaboo为macOS带来了高保真屏幕捕捉、AI分析和完整的图形界面自动化功能。版本3在CLI和MCP服务器上增加了原生代理流程和多屏幕自动化。 - 像素精确捕获（窗口、屏幕、菜单栏），并可选支持Retina 2倍缩放。- 自然语言代理，串联藏猫猫工具（查看、点击、输入、滚动、快捷键、菜单、窗口、应用、底座、空格）。- 动作优先的UI自动化，例行点击/滚动，默认在确定目标时后台有进程目标输入。- 可设置值和命名动作（set-value、perform-action）的直接辅助工具。- 通过结构化JSON进行菜单和菜单栏发现;无需点击。- 通过Tachikoma支持多提供者AI，包括托管、本地和兼容OpenAI/Anthropic的提供者。- Claude Fable 5支持，支持100万上下文和128K输出上限;保存的温度/最大令牌设置由应用和CLI共享，并根据每个型号的能力限制。
概述（AI 翻译）
Peekaboo 是一款 macOS 的 CLI 和菜单栏应用，用于屏幕截图、无障碍检查和原生 UI 自动化。直接使用它，让其代理规划多步工作，或将相同的工具集暴露给 MCP 客户端。
安装
发布的CLI和应用需要macOS 15或更高版本。
与 Homebrew 的 CLI
MCP套餐与NPM
npm 包需要 Node.js 22 或更高版本，包含 CLI 及其 MCP 启动器。
请查看MCP设置，将其连接到Codex、Claude Code、Cursor或其他MCP客户端。
Mac 应用
从最新 GitHub 版本下载签名的 DMG。菜单栏应用提供权限入驻、可视化反馈和代理会话;当你还需要 peekaboo 在 PATH 上时，请单独安装 CLI。
有关源代码构建和替代安装细节，请参见安装指南。
快速开始
检查Peekaboo可用的权限，然后截图：
屏幕录制需要屏幕录制权限。无障碍权限支持UI检查和控制;权限指南涵盖了设置及合成输入所需的额外权限。
检查一个正在运行的应用，获取带有不透明元素ID的结构化UI映射：
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Peekaboo 🫣 — Mac automation that sees the screen and does the clicks.
Peekaboo is a macOS CLI and menu-bar app for screen capture, accessibility inspection, and native UI automation. Use it directly, let its agent plan multi-step work, or expose the same toolset to MCP clients.
Install
The released CLI and app require macOS 15 or later.
CLI with Homebrew
brew install openclaw/tap/peekaboo
MCP package with npm
The npm package requires Node.js 22 or later and includes the CLI plus its MCP launcher.
npx -y @steipete/peekaboo --version
See MCP setup to connect it to Codex, Claude Code, Cursor, or another MCP client.
Mac app
Download the signed DMG from the latest GitHub release. The menu-bar app provides permission onboarding, visual feedback, and agent sessions; install the CLI separately when you also need peekaboo on PATH.
For source builds and alternative install details, see the installation guide.
Quick start
Check the permissions available to Peekaboo, then take a screenshot:
peekaboo permissions status
peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png
Screen capture requires Screen Recording permission. Accessibility permission enables UI inspection and control; the permissions guide covers setup and the additional permission used for synthetic input.
Inspect a running app to get a structured UI map with opaque element IDs:
peekaboo see --app Finder --json
That is the core loop: observe the current screen, choose an element from the result, and act on it.
安装
npx -y @steipete/peekaboo --version