Peekaboo

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question

What is Peekaboo?

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

Overview of Peekaboo

What it is

Peekaboo is a macOS CLI and menu-bar app for screen capture, accessibility inspection, and native UI automation. It can be used directly, via an agent for multi-step work, or exposed to MCP clients. The project is open source under the MIT license.

Key features

  • Screen capture of applications or the entire system with optional visual question answering through local or remote AI models.
  • Accessibility inspection to obtain a structured UI map with opaque element IDs.
  • Native UI automation including click, type, press, scroll, drag, set-value, and action commands.
  • Agent mode that combines observation and action tools into natural-language runs.
  • MCP server integration to expose the same toolset to MCP clients like Codex, Claude Code, or Cursor.
  • Background input delivery for targeted semantic and typed CLI actions when the process can be resolved.

Use cases

  • AI agents capturing screenshots of applications or the entire system for visual analysis.
  • Automating repetitive UI tasks in macOS applications, such as filling forms or navigating menus.
  • Integrating screen observation and UI control into larger workflows via MCP clients.
  • Inspecting the accessibility tree of running apps for debugging or testing.

Getting started

Install via Homebrew:shbrew install openclaw/tap/peekabooOr via npm (requires Node.js 22+):shnpx -y @steipete/peekaboo --versionOr download the signed DMG from the latest GitHub release.Quick start:shpeekaboo permissions statuspeekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.pngFor full details, see the repository README.

License and pricing

License: MIT. The project is open source with no stated pricing.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/openclawpeekaboo.svg)](https://yunodb.com/tools/openclawpeekaboo?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/openclawpeekaboo?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/openclawpeekaboo.svg" alt="Featured on YunoDB" height="20"></a>