Community画像github.com

steipete/peekaboo

macOSのスクリーンショット、UIインスペクション、クリック、タイピング、アプリ/ウィンドウの自動化を行います。

peekaboo とは?

Peekabooは、macOS上で動作する強力なGUI自動化およびスクリーンキャプチャツールです。主に画面キャプチャ、UI要素の検査、クリックやタイピングなどの操作自動化、アプリやウィンドウの管理機能を提供します。このツールは、CLI(コマンドラインインターフェース)とGUIアプリの両方で構成されており、特にアクセシビリティやスクリーンレコーディングの権限(TCC)を適切に管理しながら動作します。開発者やQAエンジニアが、テストや反復作業の自動化、リモートMacの制御などに活用できます。また、JSON形式での出力をサポートしており、機械処理や他のツールとの連携が容易です。Peekabooは、安全性を重視し、権限チェックを必須とし、ユーザーの明示的な指示なしに破壊的な操作を行わないよう設計されています。

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

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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
  • スクリーンショットには画面収録許可が必要です。クリック/タイピング/ウィンドウ制御にはアクセシビリティ許可が必要です。
  • リモート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

ワークフロー

  1. 上記のように PB を解決し、インストール状態が重要な場合はバージョンを確認します。
  2. ライブUI作業の場合は Peekaboo.app を起動し、GUIブリッジとその権限を確認します。
  3. permissions status --json を実行し、TCCが不足している場合は正確な不足許可を報告します。
  4. スクリーンショットには image を使用します。--path、--json を含め、通常 --no-remote は意図的に呼び出し元ローカルTCCをテストする場合のみ使用します。
  5. 要素のターゲティングには see --json --annotate を実行し、要素IDまたはスナップショットでクリックします。
  6. 長時間実行/変更検知スクリーンキャプチャには capture live を、ビデオフレームサンプリングには capture video を使用します。
  7. コマンド/ツールの発見には tools --json を、完全なエージェントガイドが必要な場合は learn を使用します。
  8. 出力ファイルを sips -g pixelWidth -g pixelHeight <path> または画像の表示で検証します。

ドキュメント:~/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.

関連スキル