CommunityImagengithub.com

Peekaboo

Capturas de pantalla en macOS, inspección de UI, clics, escritura y automatización de ventanas/aplicaciones.

¿Qué es Peekaboo?

Peekaboo es una herramienta de línea de comandos y una aplicación para macOS que permite la captura de pantalla, la inspección de la interfaz de usuario y la automatización de acciones como clics, escritura de texto y control de ventanas. Es especialmente útil para desarrolladores y agentes de IA que necesitan interactuar con la GUI de macOS de forma programática. La herramienta se basa en un binario CLI (`peekaboo`) y una aplicación GUI (`Peekaboo.app`) que gestiona los permisos de TCC (Transparencia, Consentimiento y Control). Para funcionar correctamente, es necesario que la aplicación esté en ejecución y que se hayan concedido los permisos de grabación de pantalla y accesibilidad. Peekaboo proporciona comandos para verificar el estado de los permisos, listar pantallas, aplicaciones y ventanas, tomar capturas de pantalla, inspeccionar elementos de la interfaz y realizar acciones automatizadas. Su diseño prioriza la seguridad, recomendando verificar siempre los permisos antes de cualquier automatización y evitar acciones destructivas a menos que el usuario lo solicite o se trate de un entorno de prueba controlado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/peekaboo

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Peekaboo?

Úsalo para captura de pantalla en macOS, inspección de UI y automatización de GUI.

Binario

  • Prefiere ~/bin/peekaboo cuando esté presente; es la copia de lanzamiento local de Peter.
  • En caso contrario, usa peekaboo.
  • Verifica primero: ~/bin/peekaboo --version || peekaboo --version.

Aplicación host de Mac

  • Inicia Peekaboo.app antes de la captura/automatización en vivo; la CLI no lo inicia automáticamente.
  • La aplicación posee las concesiones de TCC y sirve ~/Library/Application Support/Peekaboo/bridge.sock.
  • Aplicación instalada: open -a Peekaboo. Compilación desde el repositorio: compila el esquema Peekaboo de Apps/Mac/Peekaboo.xcodeproj, luego abre el Peekaboo.app resultante.
  • peekaboo daemon start no es un lanzamiento de la aplicación; el daemon tiene permisos separados y daemon.sock.
  • Verifica que peekaboo bridge status --verbose --json seleccione hostKind: gui; usa --bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock" cuando el enrutamiento determinista de la aplicación sea importante.

Seguridad

  • Verifica los permisos antes de la captura/automatización: peekaboo permissions status --json.
  • La captura de pantalla necesita Grabación de Pantalla; los clics/escritura/control de ventanas necesitan Accesibilidad.
  • En Macs remotos, la Captura de Pantalla puede estar bloqueada por la falta de Grabación de Pantalla mientras que los clics/escritura aún funcionan a través de Accesibilidad; continúa con clics o automatización de DOM cuando el objetivo sea conocido de otra manera.
  • Prefiere --json para análisis automatizado y --no-remote cuando se pruebe TCC local.
  • No hagas clic, escribas o automatices destructivamente a menos que el usuario lo haya solicitado o el objetivo sea una prueba controlada.

Comandos comunes

PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"

"$PB" permissions status --json
open -a Peekaboo
"$PB" bridge status --verbose --json
"$PB" list screens --json
"$PB" list apps --json
"$PB" list windows --app Safari --json
"$PB" image --mode screen --screen-index 0 --path /tmp/screen.png --json --no-remote
"$PB" see --app frontmost --path /tmp/frontmost.png --json --annotate
"$PB" tools --json
"$PB" learn
"$PB" click --coords 100,100 --json
"$PB" type "text" --json

Flujo de trabajo

  1. Resuelve PB como se indicó arriba y confirma la versión cuando el estado de la instalación sea relevante.
  2. Para trabajo en vivo con UI, inicia Peekaboo.app; verifica el puente GUI y sus permisos.
  3. Ejecuta permissions status --json; si falta TCC, reporta la concesión faltante exacta.
  4. Para capturas de pantalla, usa image; incluye --path, --json y normalmente --no-remote solo cuando se esté probando deliberadamente TCC del llamante local.
  5. Para apuntar a elementos, ejecuta see --json --annotate, luego haz clic por id/elemento de la instantánea.
  6. Para captura de pantalla de larga duración o consciente de cambios, usa capture live; para muestreo de fotogramas de video, usa capture video.
  7. Usa tools --json para descubrimiento de comandos/herramientas y learn cuando la guía completa del agente sea útil.
  8. Verifica los archivos de salida con sips -g pixelWidth -g pixelHeight <path> o visualiza la imagen.

Documentación: ~/Projects/Peekaboo/docs/commands/.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills relacionados