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.

GitHub Stars

611

User Rating

Not Rated

Favorites

0

Views

44

Forks

23

Issues

7

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes

Installation

Installation

Prerequisites

Please specify required software and versions:
Node.js: 20.0.0 or higher
npm: 8.0.0 or higher
macOS: 14.0 or higher
Swift: 5.9 or higher

Installation Steps

1. Install via Homebrew (Recommended)

bash
brew tap steipete/tap
brew install peekaboo

2. Direct Download

bash
curl -L https://github.com/steipete/peekaboo/releases/latest/download/peekaboo-macos-universal.tar.gz | tar xz
sudo mv peekaboo-macos-universal/peekaboo /usr/local/bin/

3. Install via npm (includes MCP server)

bash
npm install -g @steipete/peekaboo-mcp

4. Build from Source

bash
git clone https://github.com/steipete/peekaboo.git
cd peekaboo
./scripts/build-cli-standalone.sh --install

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Node.js version and reinstall dependencies. Issue: Not recognized by Claude Desktop Solution: Verify configuration file path and syntax.