Peekaboo 🫣 - Автоматизация Mac, которая видит экран и выполняет клики.

Peekaboo предоставляет высокоточное захват экрана, ИИ-анализ и полную автоматизацию GUI для macOS. Версия 3 добавляет нативные потоки агента и автоматизацию для нескольких экранов через CLI и MCP-сервер.

Что вы получаете

• Пиксельно-точные захваты (окна, экраны, меню) с опциональным масштабированием Retina 2x.
• Агент на естественном языке, который связывает инструменты Peekaboo (видеть, кликать, печатать, прокручивать, горячие клавиши, меню, окно, приложение, док, пространство).
• Автоматизация UI с приоритетом действий для рутинных кликов/прокрутки, с целевым вводом в фоне по умолчанию, когда цель известна.
• Прямые инструменты доступности для устанавливаемых значений и именованных действий (set-value, perform-action).
• Обнаружение меню и менюбара с структурированным JSON; клики не требуются.
• ИИ через нескольких провайдеров через Tachikoma, включая хостинговые, локальные и совместимые с OpenAI/Anthropic провайдеры.
• Поддержка Claude Fable 5 с 1M контекста и потолком вывода 128K; сохраненные настройки температуры/максимальных токенов используются приложением и CLI и ограничиваются возможностями каждой модели.
• MCP-сервер для Codex, Claude Code и Cursor плюс нативный CLI; одни и те же инструменты в обоих.
• Тёплый демон и Peekaboo.app Bridge хосты для автоматизации с привязкой к разрешениям, с отдельными сокетами для аренды и локальным фоллбэком.
• Настраиваемые, тестируемые рабочие процессы с воспроизводимыми сессиями и строгой типизацией.
• Требуются разрешения macOS на Запись экрана и Доступность (см. docs/permissions.md).

Установка

• Приложение macOS + CLI (Homebrew): bash brew install steipete/tap/peekaboo
• MCP-сервер (Node 22+, глобальная установка не нужна): bash npx -y @steipete/peekaboo

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

# Захват всего экрана в масштабе Retina и сохранение на Рабочий стол
peekaboo image --mode screen --retina --path ~/Desktop/screen.png

# Захват текущего состояния UI, затем копирование его снимка и непрозрачных ID элементов
peekaboo see --app Safari --json
SNAPSHOT="<snapshot-id>"
TEXT_FIELD_ID="<text-field-id>"
BUTTON_ID="<button-id>"

# Клик по кнопке по названию
peekaboo click --on "Reload this page" --snapshot "$SNAPSHOT"

# Прямая установка значения текстового поля, когда значение доступности устанавливается
peekaboo set-value --on "$TEXT_FIELD_ID" --value "hello" --snapshot "$SNAPSHOT"

# Вызов именованного действия доступности на элементе
peekaboo perform-action --on "$BUTTON_ID" --action AXPress --snapshot "$SNAPSHOT"

# Запуск автоматизации на естественном языке
peekaboo agent "Open Notes and create a TODO list with three items"

# Запуск как MCP-сервер (Codex, Claude Code, Cursor)
npx -y @steipete/peekaboo

# Минимальный фрагмент конфигурации MCP-клиента:
# {
#   "mcpServers": {
#     "peekaboo": {
#       "command": "npx",
#       "args": ["-y", "@steipete/peekaboo"],
#       "env": {
#         "PEEKABOO_AI_PROVIDERS": "openai/gpt-5.5,anthropic/claude-opus-4-8"
#       }
#     }
#   }
# }

Завершения оболочки

Peekaboo может генерировать завершения для нативных оболочек напрямую из тех же метаданных Commander, которые поддерживают справку CLI и документацию:

# Текущая оболочка (рекомендуется)
eval "$(peekaboo completions $SHELL)"

# Явное указание оболочек
eval "$(peekaboo completions zsh)"
eval "$(peekaboo completions bash)"
peekaboo completions fish | source

Для постоянной настройки и устранения неполадок см. docs/commands/completions.md.

Ввод в фоне и на переднем плане

click, type, press, hotkey и paste по умолчанию используют доставку в фоне, когда Peekaboo может определить целевой процесс по --app, --pid, --window-id или метаданным снимка. Фоновая доставка отправляет целевой ввод процессу без передачи целевому приложению переднего фокуса, поэтому скрипты могут взаимодействовать с Safari, Заметками, Терминалом и т.д., не перехватывая фокус.

Используйте --foreground, когда приложение принимает ввод только в своем активном ключевом окне, когда вам нужен реальный событие мыши на переднем плане, или когда вы намеренно управляете текущим фокусом. Флаги фокуса, такие как --space-switch и --bring-to-current-space, также подразумевают доставку на передний план. Клики по элементам/запросам сначала используют действия Доступности; ввод с клавиатуры, клики по координатам и резервный синтетический клик требуют Синтеза Событий для отправляющего процесса. Запустите peekaboo permissions request-event-synthesizing, если permissions status сообщает о его отсутствии.

# Фоновый режим: цель — Safari без его активации
peekaboo click "Address and search bar" --app Safari
peekaboo type "github.com/openclaw/Peekaboo" --app Safari --return

Передний план: сначала сделайте Safari активным для приложений/полей, отклоняющих ввод в фоне

peekaboo click "Address and search bar" --app Safari --foreground
peekaboo type "github.com/openclaw/Peekaboo" --app Safari --return --foreground

Модели и провайдеры

Список провайдеров Peekaboo обновляется вместе с Tachikoma и каталогом протестированных моделей. Смотрите docs/providers.md для актуального справочника по провайдерам, включая OpenAI, Anthropic, xAI/Grok, Google Gemini, MiniMax, Kimi, Ollama, LM Studio и совместимые пользовательские конечные точки.

Настройка провайдеров через PEEKABOO_AI_PROVIDERS или peekaboo config add. Настройки генерации агента находятся в agent.temperature и agent.maxTokens в файле ~/.peekaboo/config.json; интерфейс настроек macOS читает и записывает те же значения.

Узнайте больше

• Вектор развития проекта: VISION.md
• Справочник по командам: docs/commands/
• Поддержка платформ: docs/platform-support.md
• Архитектура: docs/ARCHITECTURE.md
• Сборка из исходного кода: docs/building.md
• Руководство по тестированию: docs/testing/tools.md
• Настройка MCP: docs/commands/mcp.md
• Разрешения: docs/permissions.md
• Ollama/локальные модели: docs/ollama.md
• Цикл чата агента: docs/agent-chat.md
• Справочник по API сервиса: docs/service-api-reference.md

Сообщество

• PeekabooWin — переписанный под Windows цикл автоматизации Peekaboo (JavaScript + PowerShell), автор @FelixKruger
• PeekabooX — переписанный под Linux цикл автоматизации Peekaboo (Rust + Python), автор @nordbyte

Основы разработки

• Требования: см. docs/platform-support.md. Node 22+ необходим только для npm-обёртки MCP и вспомогательных скриптов pnpm.
• Установка зависимостей: pnpm install, затем pnpm run build:cli или pnpm run test:safe.
• Линтер/форматирование: pnpm run lint && pnpm run format.

Лицензия

MIT