CommunityImagegithub.com

steipete/peekaboo

Captures d'écran macOS, inspection UI, clics, saisie, automatisation des fenêtres et applications.

Qu'est-ce que peekaboo ?

Peekaboo est un outil puissant pour l'automatisation et l'inspection de l'interface graphique (GUI) sur macOS. Il permet de réaliser des captures d'écran, d'inspecter les éléments UI, d'effectuer des clics et de la saisie automatisée, ainsi que de contrôler les fenêtres et les applications. Le binaire peut être localisé dans `~/bin/peekaboo` ou via `peekaboo` dans le PATH. L'application hôte Mac (Peekaboo.app) doit être lancée avant toute capture ou automatisation en direct, car le CLI ne la lance pas automatiquement. Il est nécessaire de vérifier les permissions (enregistrement d'écran et accessibilité) via `peekaboo permissions status --json`. Il fonctionne avec les CLI standards, propose un mode JSON pour le parsing machine, et se déploie via un socket de bridge (`bridge.sock`). Les workflows incluent la prise de capture (`image`), la découverte d'éléments (`see`), le clic par coordonnées (`click`), la saisie de texte (`type`), et la capture vidéo en continu (`capture live/video`).

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait peekaboo ?

Utilisé pour la capture d'écran, l'inspection UI et l'automatisation GUI sur macOS.

Binaire

  • Préfèrez ~/bin/peekaboo lorsqu'il est présent ; c'est la copie locale de la release de Peter.
  • Sinon, utilisez peekaboo.
  • Vérifiez d'abord : ~/bin/peekaboo --version || peekaboo --version.

Hôte d'application Mac

  • Lancez Peekaboo.app avant la capture/l'automatisation en direct ; le CLI ne le lance pas automatiquement.
  • L'application possède les autorisations TCC et sert ~/Library/Application Support/Peekaboo/bridge.sock.
  • Application installée : open -a Peekaboo. Build depuis le dépôt : compilez le schéma Peekaboo de Apps/Mac/Peekaboo.xcodeproj, puis ouvrez le Peekaboo.app résultant.
  • peekaboo daemon start n'est pas un lancement d'application ; le démon a des permissions séparées et son propre daemon.sock.
  • Vérifiez que peekaboo bridge status --verbose --json renvoie hostKind: gui ; utilisez --bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock" lorsque le routage déterministe de l'application est important.

Sécurité

  • Vérifiez les permissions avant capture/automatisation : peekaboo permissions status --json.
  • Les captures d'écran nécessitent l'Enregistrement d'écran ; les clics/saisie/contrôle des fenêtres nécessitent l'Accessibilité.
  • Sur les Mac distants, la capture d'écran peut être bloquée si l'Enregistrement d'écran est manquant, tandis que les clics/saisie fonctionnent encore via l'Accessibilité ; continuez avec les clics ou l'automatisation DOM lorsque la cible est autrement connaissable.
  • Préfèrez --json pour le parsing machine et --no-remote lors des tests TCC locaux.
  • Ne cliquez/tapez/automatisez pas de manière destructive, sauf si l'utilisateur le demande ou si la cible est un test contrôlé.

Commandes courantes

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

Workflow

  1. Résolvez PB comme ci-dessus et confirmez la version lorsque l'état d'installation est important.
  2. Pour le travail UI en direct, lancez Peekaboo.app ; vérifiez le bridge GUI et ses permissions.
  3. Exécutez permissions status --json ; si TCC manquant, signalez exactement l'autorisation manquante.
  4. Pour les captures d'écran, utilisez image ; incluez --path, --json, et généralement --no-remote uniquement lorsque vous testez délibérément le TCC de l'appelant.
  5. Pour le ciblage d'éléments, exécutez see --json --annotate, puis cliquez par identifiant/snapshot d'élément.
  6. Pour la capture d'écran longue durée/sensible aux changements, utilisez capture live ; pour l'échantillonnage vidéo, utilisez capture video.
  7. Utilisez tools --json pour la découverte de commandes/outils et learn lorsque le guide complet de l'agent est utile.
  8. Vérifiez les fichiers de sortie avec sips -g pixelWidth -g pixelHeight <path> ou visualisez l'image.

Documentation : ~/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 associés