O que peekaboo faz?
Use para captura de tela do macOS, inspeção de UI e automação de GUI.
Binário
- Prefira
~/bin/peekabooquando 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.appantes 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 esquemaPeekaboodeApps/Mac/Peekaboo.xcodeproje depois abra oPeekaboo.appresultante. peekaboo daemon startnão é uma inicialização do aplicativo; o daemon tem permissões separadas edaemon.sock.- Verifique se
peekaboo bridge status --verbose --jsonselecionahostKind: 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
--jsonpara análise por máquina e--no-remoteao 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
- Resolva
PBcomo acima e confirme a versão quando o estado da instalação for importante. - Para trabalho de UI ao vivo, inicie
Peekaboo.app; verifique a ponte GUI e suas permissões. - Execute
permissions status --json; se faltar TCC, reporte a concessão exata ausente. - Para capturas de tela, use
image; inclua--path,--json, e geralmente--no-remoteapenas ao testar deliberadamente TCC local do chamador. - Para segmentação de elementos, execute
see --json --annotate, depois clique por id do elemento/snapshot. - Para captura de tela de longa duração/consciente de alterações, use
capture live; para amostragem de quadros de vídeo, usecapture video. - Use
tools --jsonpara descoberta de comandos/ferramentas elearnquando o guia completo do agente for útil. - Verifique arquivos de saída com
sips -g pixelWidth -g pixelHeight <caminho>ou visualize a imagem.
Docs: ~/Projects/Peekaboo/docs/commands/.