Peekaboo — это приложение для macOS с CLI и меню для захвата экрана, проверки доступности и нативной автоматизации интерфейса. Используйте его напрямую, дайте агенту планировать многошаговое выполнение или откройте тот же набор инструментов для клиентов MCP.

Установка

Вышедший CLI и приложение требуют macOS 15 или новее.

CLI с Homebrew

Пакет MCP с npm

Пакет npm требует Node.js 22 или более поздних и включает CLI плюс пусковую установку MCP.

См. MCP setup для подключения к Codex, Claude Code, Cursor или другому MCP-клиенту.

Приложение для Mac

Скачайте подписанный DMG с последнего релиза на GitHub. Приложение в меню предоставляет разрешение на подключение, визуальную обратную связь и сессии агентов; устанавливайте CLI отдельно, если вам также нужен peekaboo на PATH.

Для исходных сборок и альтернативных деталей установки смотрите руководство по установке.

Быстрый старт

Проверьте доступные разрешения для Peekaboo, затем сделайте скриншот:

Для захвата экрана требуется разрешение на запись экрана. Разрешение доступности позволяет проверять и управлять интерфейсом; руководство по разрешениям охватывает настройки и дополнительные разрешения, используемые для синтетического ввода.

Проверьте запущенное приложение, чтобы получить структурированную карту интерфейса с непрозрачными идентификаторами элементов:

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.