¿Qué hace Peekaboo?
Úsalo para captura de pantalla en macOS, inspección de UI y automatización de GUI.
Binario
- Prefiere
~/bin/peekaboocuando 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.appantes 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 esquemaPeekaboodeApps/Mac/Peekaboo.xcodeproj, luego abre elPeekaboo.appresultante. peekaboo daemon startno es un lanzamiento de la aplicación; el daemon tiene permisos separados ydaemon.sock.- Verifica que
peekaboo bridge status --verbose --jsonseleccionehostKind: 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
--jsonpara análisis automatizado y--no-remotecuando 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
- Resuelve
PBcomo se indicó arriba y confirma la versión cuando el estado de la instalación sea relevante. - Para trabajo en vivo con UI, inicia
Peekaboo.app; verifica el puente GUI y sus permisos. - Ejecuta
permissions status --json; si falta TCC, reporta la concesión faltante exacta. - Para capturas de pantalla, usa
image; incluye--path,--jsony normalmente--no-remotesolo cuando se esté probando deliberadamente TCC del llamante local. - Para apuntar a elementos, ejecuta
see --json --annotate, luego haz clic por id/elemento de la instantánea. - Para captura de pantalla de larga duración o consciente de cambios, usa
capture live; para muestreo de fotogramas de video, usacapture video. - Usa
tools --jsonpara descubrimiento de comandos/herramientas ylearncuando la guía completa del agente sea útil. - Verifica los archivos de salida con
sips -g pixelWidth -g pixelHeight <path>o visualiza la imagen.
Documentación: ~/Projects/Peekaboo/docs/commands/.