메뉴
Use Peekaboo on macOS for GUI-level automation (screenshots, UI inspection, clicks/typing, window/app control). Trigger this skill when tasks require real GUI interaction, screenshot automation, or browser-level automation on macOS.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when the user mentions Feishu. Handles Feishu Docs/Drive/Wiki operations in Chrome via Playwright only, preferring headless execution with saved auth state. Supports browsing, reading, summarizing, editing, publishing local files as separate Feishu docs, deterministic template-center creation, and true wiki child-page creation via move-into-wiki flow. If login is stale, switch to QR login in a visible browser.
Git operations for local repos and GitHub workflows. Use when Codex needs to inspect repo state, craft commits, manage branches, rebase/merge safely, or decide on Git/GitHub commands (including gh usage) while following safety constraints and commit conventions.
Create, edit, validate, and render Mermaid diagrams (.mmd or Mermaid blocks in Markdown/HTML). Use when asked to convert visuals or specs into Mermaid, fix Mermaid syntax errors, add labels/line breaks, or render SVG/PNG via mmdc or a Mermaid CDN.
Use when Codex is asked to automate local GUI workflows with SakuraProj using skpr-local/skpr-cli scripts, including probe-driven readiness and repeatable local task orchestration.
Use when handling JavaScript package management and scripts, with pnpm as the default package manager.
Use when validating web UI runtime behavior with browser automation, including JavaScript errors, console logs, and rendered DOM checks.
| name | macos-gui-automation |
| description | Use Peekaboo on macOS for GUI-level automation (screenshots, UI inspection, clicks/typing, window/app control). Trigger this skill when tasks require real GUI interaction, screenshot automation, or browser-level automation on macOS. |
This skill guides reliable macOS GUI automation using Peekaboo (CLI/MCP). Use it for screenshot-driven UI validation, input automation, app/window control, and browser-level tests when headless automation is insufficient.
npx). If using npx, Node 22+ is required.Prefer Homebrew for persistent use:
brew install steipete/tap/peekaboo
For one-off usage:
npx -y @steipete/peekaboo
Check permissions:
peekaboo permissions status
peekaboo list permissions
# If using an older build, try:
# peekaboo permissions check
Request permissions (if needed):
peekaboo permissions grant screen-recording
peekaboo permissions grant accessibility
# If using an older build, try:
# peekaboo permissions request screen-recording
# peekaboo permissions request accessibility
See the screen and identify elements (capture + snapshot id):
peekaboo see --json-output
Click by text using a snapshot id:
peekaboo click --on "OK" --snapshot "<snapshot_id>"
Example snapshot capture pipeline:
SNAPSHOT=$(peekaboo see --app Safari --json-output | jq -r '.data.snapshot_id')
peekaboo click --on "Reload this page" --snapshot "$SNAPSHOT"
Type text:
peekaboo type "hello world"
Send hotkeys:
peekaboo hotkey cmd,shift,4
Scroll:
peekaboo scroll down
Target a specific app or window:
peekaboo app list
peekaboo window list
Capture a screenshot:
peekaboo image
Run a natural-language automation:
peekaboo "Open Notes and create a TODO list with three items"
peekaboo see to confirm the current UI state before clicking.see or image returns empty output, re-check Screen Recording permission.click or type fails, re-check Accessibility permission.