CommunityBildgithub.com

steipete/peekaboo

macOS-Bildschirmaufnahmen, UI-Inspektion, Klicks, Texteingabe und Automatisierung von Apps/Fenstern.

Was ist peekaboo?

Peekaboo ist ein leistungsstarkes CLI-Tool und eine macOS-App zur Bildschirmaufnahme, UI-Inspektion und GUI-Automatisierung. Es ermöglicht Entwicklern und KI-Agenten, Screenshots zu erstellen, UI-Elemente zu identifizieren, Klicks und Texteingaben auszuführen sowie Fenster und Apps zu steuern. Das Tool unterstützt zwei Betriebsmodi: eine GUI-Bridge (Peekaboo.app) mit vollen TCC-Berechtigungen (Bildschirmaufnahme, Bedienungshilfen) und einen separaten Daemon mit eigenen Rechten. Typische Anwendungsfälle umfassen das Erstellen von Screenshots mit `image`, das Identifizieren von Elementen mit `see`, das Klicken auf Koordinaten mit `click` und das Senden von Texteingaben mit `type`. Die Ausgabe erfolgt bevorzugt im JSON-Format für die maschinelle Verarbeitung. Vor der Automatisierung sollte stets der Berechtigungsstatus überprüft werden, da fehlende Berechtigungen (z. B. Bildschirmaufnahme auf entfernten Macs) zu Fehlfunktionen führen können. Peekaboo arbeitet eng mit macOS zusammen und erfordert, dass die App vor Live-Aufnahmen gestartet wird.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht peekaboo?

Verwendung für macOS-Bildschirmaufnahmen, UI-Inspektion und GUI-Automatisierung.

Binärdatei

  • Bevorzugt ~/bin/peekaboo wenn vorhanden; dies ist Peters lokale Release-Kopie.
  • Andernfalls peekaboo verwenden.
  • Zuerst prüfen: ~/bin/peekaboo --version || peekaboo --version.

Mac-App-Host

  • Peekaboo.app vor der Live-Aufnahme/-Automatisierung starten; die CLI startet sie nicht automatisch.
  • Die App besitzt TCC-Berechtigungen und bedient ~/Library/Application Support/Peekaboo/bridge.sock.
  • Installierte App: open -a Peekaboo. Repository-Build: Das Schema Peekaboo in Apps/Mac/Peekaboo.xcodeproj bauen, dann die resultierende Peekaboo.app öffnen.
  • peekaboo daemon start ist kein App-Start; der Daemon hat separate Berechtigungen und daemon.sock.
  • Überprüfen mit peekaboo bridge status --verbose --json, ob hostKind: gui ausgewählt ist; --bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock" verwenden, wenn deterministisches App-Routing erforderlich ist.

Sicherheit

  • Berechtigungen vor der Aufnahme/Automatisierung prüfen: peekaboo permissions status --json.
  • Für Screenshots wird Bildschirmaufnahme benötigt; Klicks/Texteingabe/Fenstersteuerung benötigen Bedienungshilfen.
  • Auf entfernten Macs kann der Screenshot durch fehlende Bildschirmaufnahme blockiert sein, während Klicks/Texteingabe über Bedienungshilfen weiterhin funktionieren; mit Klicks oder DOM-Automatisierung fortfahren, wenn das Ziel anderweitig bekannt ist.
  • --json für maschinelle Verarbeitung und --no-remote beim Testen lokaler TCC bevorzugen.
  • Nicht klicken/tippen/destruktiv automatisieren, es sei denn, der Benutzer hat es verlangt oder das Ziel ist ein kontrollierter Test.

Häufige Befehle

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

Arbeitsablauf

  1. PB wie oben ermitteln und Version bestätigen, wenn der Installationsstatus relevant ist.
  2. Für Live-UI-Arbeit Peekaboo.app starten; die GUI-Bridge und ihre Berechtigungen überprüfen.
  3. permissions status --json ausführen; falls TCC fehlt, die genaue fehlende Berechtigung melden.
  4. Für Screenshots image verwenden; --path, --json und normalerweise --no-remote nur einschließen, wenn absichtlich die aufruferlokale TCC getestet wird.
  5. Für Elementziele see --json --annotate ausführen, dann per Element-ID/Schnappschuss klicken.
  6. Für langlebige/änderungsbewusste Bildschirmaufnahme capture live verwenden; für Video-Frame-Sampling capture video verwenden.
  7. tools --json zur Befehls-/Werkzeugsuche und learn verwenden, wenn die vollständige Agentenanleitung nützlich ist.
  8. Ausgabedateien mit sips -g pixelWidth -g pixelHeight <path> überprüfen oder das Bild anzeigen.

Dokumentation: ~/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.

Verwandte Skills