CommunityImagemgithub.com

steipete/peekaboo

Capturas de tela no macOS, inspeção de UI, cliques, digitação e automação de janelas/aplicativos.

O que é peekaboo?

Peekaboo é uma ferramenta poderosa para automação de GUI no macOS, permitindo captura de tela, inspeção de interface, cliques, digitação e controle de janelas e aplicativos. Ela suporta tanto uma interface de linha de comando (CLI) quanto um aplicativo nativo (Peekaboo.app) para recursos avançados de ponte e permissões. O uso típico envolve verificar permissões (Screen Recording e Accessibility), iniciar o aplicativo host, e então usar comandos como `image` para capturas, `see` para inspeção de elementos, e `click`/`type` para automação. A ferramenta se integra perfeitamente com agentes de IA como Claude Code, Codex e Cursor, fornecendo saída JSON para fácil processamento e um guia de aprendizado embutido (`learn`). Recomenda-se sempre verificar permissões antes da automação e usar `--no-remote` apenas para testes locais de TCC.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que peekaboo faz?

Use para captura de tela do macOS, inspeção de UI e automação de GUI.

Binário

  • Prefira ~/bin/peekaboo quando presente; é a cópia local de Peter.
  • Caso contrário, use peekaboo.
  • Verifique primeiro: ~/bin/peekaboo --version || peekaboo --version.

Aplicativo host Mac

  • Inicie o Peekaboo.app antes de captura/automação ao vivo; a CLI não o inicia automaticamente.
  • O aplicativo possui as concessões TCC e serve ~/Library/Application Support/Peekaboo/bridge.sock.
  • Aplicativo instalado: open -a Peekaboo. Compilação do repositório: construa o esquema Peekaboo de Apps/Mac/Peekaboo.xcodeproj e depois abra o Peekaboo.app resultante.
  • peekaboo daemon start não é uma inicialização do aplicativo; o daemon tem permissões separadas e daemon.sock.
  • Verifique se peekaboo bridge status --verbose --json seleciona hostKind: gui; use --bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock" quando o roteamento determinístico do aplicativo for importante.

Segurança

  • Verifique permissões antes de captura/automação: peekaboo permissions status --json.
  • Captura de tela precisa de Screen Recording; cliques/digitação/controle de janelas precisam de Accessibility.
  • Em Macs remotos, a captura de tela pode ser bloqueada pela falta de Screen Recording enquanto cliques/digitação ainda funcionam via Accessibility; continue com cliques ou automação DOM quando o alvo for conhecível de outra forma.
  • Prefira --json para análise por máquina e --no-remote ao testar TCC local.
  • Não clique/digite/automatize destrutivamente a menos que o usuário tenha solicitado ou o alvo seja um teste controlado.

Comandos Comuns

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

Fluxo de Trabalho

  1. Resolva PB como acima e confirme a versão quando o estado da instalação for importante.
  2. Para trabalho de UI ao vivo, inicie Peekaboo.app; verifique a ponte GUI e suas permissões.
  3. Execute permissions status --json; se faltar TCC, reporte a concessão exata ausente.
  4. Para capturas de tela, use image; inclua --path, --json, e geralmente --no-remote apenas ao testar deliberadamente TCC local do chamador.
  5. Para segmentação de elementos, execute see --json --annotate, depois clique por id do elemento/snapshot.
  6. Para captura de tela de longa duração/consciente de alterações, use capture live; para amostragem de quadros de vídeo, use capture video.
  7. Use tools --json para descoberta de comandos/ferramentas e learn quando o guia completo do agente for útil.
  8. Verifique arquivos de saída com sips -g pixelWidth -g pixelHeight <caminho> ou visualize a imagem.

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

Habilidades Relacionadas