Peekaboo

项目概述

Peekaboo是一款macOS CLI和菜单栏应用，提供屏幕捕获、无障碍检查（accessibility inspection）和原生UI自动化能力。可直接使用，也可让AI代理规划多步骤工作流，或将同一工具集暴露给MCP客户端。

主要功能

• 屏幕截图：捕获应用窗口或整个系统屏幕
• UI检查：获取结构化UI地图，包含元素ID
• UI自动化：点击、输入文本、按键等操作
• MCP服务器支持：可连接Codex、Claude Code、Cursor等MCP客户端
• 后台自动化：支持后台按键和UI操作
• 签名Bridge凭证：支持后台自动化

适用人群

• 需要macOS UI自动化的开发者
• 使用AI编码代理（Claude Code、Codex、Cursor）的用户
• 希望为AI代理提供屏幕感知能力的工程师

快速上手

# 通过Homebrew安装CLI（需macOS 15+）
brew install steipete/tap/peekaboo

# 或通过npm安装MCP包（需Node.js 22+）
npx -y @steipete/peekaboo --version

检查权限并截图：

peekaboo permissions status
peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png

核心优势

• MCP原生支持，与AI代理深度集成
• 支持后台UI操作，无需应用前置
• 提供CLI和菜单栏应用两种界面
• 开源免费（MIT）

系统要求

• 操作系统：macOS 15或更高版本
• 额外依赖：Node.js 22+（npm包）