# openclaw/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.

Repository: https://github.com/openclaw/Peekaboo
Canonical: https://ross.abutalabs.com/products/peekaboo
Homepage: http://www.peekaboo.boo
Language: Swift
License: MIT
License Family: permissive
Topics: ai, macos, mcp, screenshots, swift
Last push: 2026-08-26T23:24:14+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 33
- inputs: {"age_days": 468, "days_push": 7, "days_rel": 13, "gap_med": 2, "n_releases_24m": 44}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5061, forks 387 (observed 2026-08-28T04:09:09.153250+00:00)

## What it is
Peekaboo is a macOS CLI and menu-bar app that captures screenshots, inspects the accessibility tree, and automates native UI interactions like clicking and typing. It also ships an MCP server so AI clients such as Claude Code, Codex, and Cursor can drive the desktop, with optional visual question answering via local or remote AI models.

## Use cases
- capture screenshots of apps or the whole screen from the command line
- let AI agents see and control the macOS desktop
- inspect a running app's UI elements for automation
- expose screen capture and UI automation tools to MCP clients
- automate clicking, typing, and scrolling in native macOS apps
- run visual question answering on screenshots with AI models

## When to choose
- you need scriptable screen capture and UI automation on macOS
- you want to give AI coding agents eyes and hands on the desktop
- you use MCP clients like Claude Code, Codex, or Cursor and want desktop tools
- you need structured accessibility-tree maps of running applications

## When to avoid
- you need automation on Linux or Windows - it is macOS-only and requires macOS 15+
- you only need browser automation, where browser-specific tools fit better
- you cannot grant Screen Recording and Accessibility permissions, e.g. locked-down corporate machines

## Facets
- artifact type: cli-tool
- maturity: active
- function: computer-vision, image-processing, mcp, agent-framework, cli, gui, developer-tools
- domain: developer-tools, artificial-intelligence, desktop-applications
- platform: cli
- tags: screen-capture, ui-automation, accessibility, screenshot-analysis, mcp-server, menu-bar-app, ai-agents, visual-question-answering, automation, command-line, macos, nodejs, swift

## Member repositories
- openclaw/Peekaboo (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:09.153250+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:17:18.941946+00:00, confidence not recorded.
  - readme: https://github.com/openclaw/Peekaboo (fetched 2026-08-28T04:09:09.153250+00:00, sha 81d52b0331c6)
  - homepage: http://www.peekaboo.boo (fetched 2026-08-29T08:57:44.631334+00:00, sha 324293c35af2)
  - site_page: https://peekaboo.sh/install.html (fetched 2026-08-29T08:57:44.641496+00:00, sha 59c00db5853e)
  - site_page: https://peekaboo.sh/quickstart.html (fetched 2026-08-29T08:57:44.643668+00:00, sha 285e014f7a2f)
- Data as of 2026-08-30T08:39:29.467469+00:00.