How do I install Peekaboo?

Install Peekaboo via npm using `npx -y @steipete/peekaboo-mcp@beta`. You also may need to grant screen recording permissions in System Preferences.

What AI providers does Peekaboo support?

Peekaboo supports Ollama (for local AI) and OpenAI. Using the PEEKABOO_AI_PROVIDERS environment variable, you can specify which models to use, such as 'ollama/llava:latest' or 'openai/gpt-4o'.

What macOS version is required?

Peekaboo requires macOS 14.0 (Sonoma) or later.

Peekaboo is a macOS utility that captures screenshots without user interaction, allowing AI assistants to visually analyze UI bugs, designs, and data.

Can Peekaboo capture multiple windows at once?

Yes, Peekaboo can capture multiple windows of an application simultaneously.

Peekaboo

Name: Peekaboo
Author: steipete

bysteipete

•

2,908

•

Developer Tools

Productivity & Workflow

Other

Captures screenshots on macOS without user interaction, enabling AI assistants to visually analyze UI bugs, designs, and data.

Peekaboo is a macOS utility designed to provide AI assistants with visual perception by capturing screenshots without requiring manual user input. It acts as a bridge between your screen and AI models, allowing them to 'see' and analyze UI elements, charts, and other visual data. This tool simplifies tasks such as bug hunting, design reviews, and UI testing by enabling AI to understand the context of the screen, making it an invaluable tool for developers and designers seeking to integrate AI into their workflows.

Key Features

01Configurable logging levels and file paths for debugging

0237 GitHub stars

03Offers options to save images or return image data as Base64

04Captures screenshots of screens, windows, or entire applications

05Provides AI analysis of captured images via configurable AI providers (Ollama, OpenAI)

06Allows capturing multiple windows of an application simultaneously

Use Cases

01Automating design review processes with AI feedback

02Facilitating AI analysis of charts and visual data

03Enabling AI-driven bug reporting and UI testing