peekaboo은(는) 무엇을 하나요?
macOS 화면 캡처, UI 검사 및 GUI 자동화에 사용합니다.
바이너리
~/bin/peekaboo가 존재하면 우선 사용합니다. 이는 Peter의 로컬 릴리스 사본입니다.- 그렇지 않으면
peekaboo를 사용합니다. - 먼저 확인:
~/bin/peekaboo --version || peekaboo --version.
Mac 앱 호스트
- 라이브 캡처/자동화 전에
Peekaboo.app을 실행하세요. CLI가 자동으로 실행하지 않습니다. - 앱이 TCC 권한을 소유하며
~/Library/Application Support/Peekaboo/bridge.sock을 제공합니다. - 설치된 앱:
open -a Peekaboo. 저장소 빌드:Apps/Mac/Peekaboo.xcodeproj의Peekaboo스킴을 빌드한 후 생성된Peekaboo.app을 엽니다. peekaboo daemon start는 앱 실행이 아닙니다. 데몬은 별도의 권한과daemon.sock을 가집니다.peekaboo bridge status --verbose --json에서hostKind: gui를 선택했는지 확인하세요. 결정적인 앱 라우팅이 필요한 경우--bridge-socket "$HOME/Library/Application Support/Peekaboo/bridge.sock"을 사용하세요.
안전
- 캡처/자동화 전에 권한을 확인하세요:
peekaboo permissions status --json. - 스크린샷에는 화면 기록(Screen Recording) 권한이 필요합니다. 클릭/타이핑/창 제어에는 접근성(Accessibility) 권한이 필요합니다.
- 원격 Mac에서는 화면 기록이 없어 스크린샷이 차단될 수 있지만, 접근성 권한을 통해 클릭/타이핑은 여전히 작동합니다. 대상이 다른 방법으로 알 수 있는 경우 클릭이나 DOM 자동화로 계속 진행하세요.
- 머신 파싱에는
--json을, 로컬 TCC 테스트 시에는--no-remote를 선호합니다. - 사용자가 요청했거나 대상이 통제된 테스트 환경이 아닌 경우 클릭/타이핑/파괴적 자동화를 수행하지 마세요.
일반 명령어
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
워크플로우
- 위와 같이
PB를 확인하고 설치 상태가 중요한 경우 버전을 확인합니다. - 라이브 UI 작업을 위해
Peekaboo.app을 실행합니다. GUI 브리지와 해당 권한을 확인합니다. permissions status --json을 실행합니다. TCC가 누락된 경우 정확히 누락된 권한을 보고합니다.- 스크린샷의 경우
image를 사용합니다.--path,--json을 포함하고, 의도적으로 호출자 로컬 TCC를 테스트하는 경우에만--no-remote를 사용합니다. - 요소 타겟팅의 경우
see --json --annotate를 실행한 후 요소 ID/스냅샷으로 클릭합니다. - 장기 실행/변경 감지 화면 캡처에는
capture live를, 비디오 프레임 샘플링에는capture video를 사용합니다. - 명령/도구 탐색에는
tools --json을, 전체 에이전트 가이드가 유용할 때는learn을 사용합니다. sips -g pixelWidth -g pixelHeight <path>로 출력 파일을 확인하거나 이미지를 봅니다.
문서: ~/Projects/Peekaboo/docs/commands/.