Peekaboo

Name: Peekaboo
Author: bighardperson

bighardperson/computer-science-skills-collection

8 installs
33 repo stars
Updated April 26, 2026
bighardperson/computer-science-skills-collection

peekaboo is a Claude skill wrapping a macOS UI automation CLI that captures screens, targets UI elements, and drives clicks, typing, and hotkeys.

About

peekaboo is a macOS UI automation CLI that captures and inspects screens, targets UI elements, drives input, and manages apps, windows, and menus. An agent uses `see` to annotate a screenshot and identify targets, then click, type, drag, or use hotkeys against those elements. It requires Screen Recording and Accessibility permissions.

Full macOS UI automation CLI: capture, inspect, target, and drive input
See-then-act flow: annotate a screenshot, then click or type against elements
Manages apps, windows, menus, dock, and clipboard

Peekaboo by the numbers

8 all-time installs (skills.sh)
Ranked #1,522 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
Data as of Jul 30, 2026 (Skillselion catalog sync)

At a glance

peekaboo capabilities & compatibility

Free; requires macOS Screen Recording and Accessibility permissions.

Capabilities: testing
Use cases: testing
Platforms: macOS
Pricing: Free

From the docs

What peekaboo says it does

Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus.

SKILL.md

Requires Screen Recording + Accessibility permissions.

SKILL.md

npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill peekaboo

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/bighardperson/computer-science-skills-collection/peekaboo.svg)](https://skillselion.com/skills/bighardperson/computer-science-skills-collection/peekaboo)

Installs	8
repo stars	★ 33
Last updated	April 26, 2026
Repository	bighardperson/computer-science-skills-collection ↗

What it does

Automate and drive macOS UI by capturing screens, targeting elements, and sending clicks, typing, and hotkeys.

Who is it for?

Scripting and automating macOS GUI apps by seeing then acting on UI elements.

Skip if: Non-macOS platforms; it targets macOS and needs Screen Recording plus Accessibility permissions.

When should I use this skill?

You need to capture, inspect, or automate the macOS UI from the command line.

What you get

Automated macOS UI actions such as annotated screenshots, element clicks, typed input, and window management.

Annotated screenshots and automated UI actions on macOS

By the numbers

Ships 11 core commands and 9 interaction commands (click, drag, hotkey, type, and more)

Files

SKILL.mdMarkdownGitHub ↗

Peekaboo

Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus.

Features

Core: bridge, capture, clean, config, image, learn, list, permissions, run, sleep, tools Interaction: click, drag, hotkey, move, paste, press, scroll, swipe, type System: app, clipboard, dialog, dock, menu, menubar, open, space, window Vision: see

Quickstart

peekaboo permissions
peekaboo list apps --json
peekaboo see --annotate --path /tmp/peekaboo-see.png
peekaboo click --on B1
peekaboo type "Hello" --return

Targeting parameters

App/window: --app, --pid, --window-title, --window-id, --window-index
Snapshot: --snapshot (ID from see)
Element/coords: --on/--id, --coords x,y

Examples

peekaboo see --app Safari --annotate --path /tmp/see.png
peekaboo click --on B3 --app Safari
peekaboo type "user@example.com" --app Safari
peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
peekaboo app launch "Safari" --open https://example.com
peekaboo menu click --app Safari --item "New Window"
peekaboo hotkey --keys "cmd,shift,t"

Notes