jpskill.com
🛠️ 開発・MCP コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🛠️ Peekaboo

peekaboo

macOSのユーザーインターフェースをコマンドラインインターフェースでキャプチャし、自動化するためのSkillです。

⚡ ⏱ テスト計画作成 2時間 → 20分
📜 元の英語説明(参考)

Capture and automate macOS UI with the Peekaboo CLI.

🇯🇵 日本人クリエイター向け解説

一言でいうと

macOSのユーザーインターフェースをコマンドラインインターフェースでキャプチャし、自動化するためのSkillです。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o peekaboo.zip https://jpskill.com/download/5196.zip && unzip -o peekaboo.zip && rm peekaboo.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5196.zip -OutFile "$d\peekaboo.zip"; Expand-Archive "$d\peekaboo.zip" -DestinationPath $d -Force; ri "$d\peekaboo.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して peekaboo.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → peekaboo フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-18
同梱ファイル
1

💬 こう話しかけるだけ — サンプルプロンプト

  • › Peekaboo を使って、最小構成のサンプルコードを示して
  • › Peekaboo の主な使い方と注意点を教えて
  • › Peekaboo を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Peekaboo

Peekaboo は、macOS の UI オートメーションを完全に実行する CLI ツールです。画面のキャプチャ/検査、UI 要素のターゲット設定、入力の駆動、アプリ/ウィンドウ/メニューの管理が可能です。コマンドはスナップショットキャッシュを共有し、スクリプト用に --json/-j をサポートしています。フラグについては peekaboo または peekaboo <cmd> --help を実行してください。peekaboo --version はビルドのメタデータを出力します。ヒント: polter peekaboo を介して実行すると、常に最新のビルドが保証されます。

機能 (エージェント/MCP を除くすべての CLI 機能)

コア

  • bridge: Peekaboo Bridge ホストの接続性を検査します。
  • capture: ライブキャプチャまたはビデオ取り込み + フレーム抽出を行います。
  • clean: スナップショットキャッシュと一時ファイルを削除します。
  • config: 初期化/表示/編集/検証、プロバイダー、モデル、資格情報を管理します。
  • image: スクリーンショットをキャプチャします (画面/ウィンドウ/メニューバーの領域)。
  • learn: 完全なエージェントガイド + ツールカタログを出力します。
  • list: アプリ、ウィンドウ、画面、メニューバー、権限を一覧表示します。
  • permissions: 画面収録/アクセシビリティのステータスを確認します。
  • run: .peekaboo.json スクリプトを実行します。
  • sleep: 指定した期間、実行を一時停止します。
  • tools: フィルタリング/表示オプション付きで利用可能なツールを一覧表示します。

インタラクション

  • click: スマートな待機機能で ID/クエリ/座標によってターゲットをクリックします。
  • drag: 要素/座標/Dock 間でドラッグ＆ドロップします。
  • hotkey: cmd,shift,t のような修飾キーの組み合わせを実行します。
  • move: オプションのスムージング機能でカーソルを配置します。
  • paste: クリップボードを設定 -> ペースト -> 復元します。
  • press: 繰り返し機能付きで特殊キーシーケンスを押します。
  • scroll: 方向性のあるスクロールを実行します (ターゲット指定 + スムーズ)。
  • swipe: ターゲット間でジェスチャー形式のドラッグを実行します。
  • type: テキスト + 制御キーを入力します (--clear、遅延機能付き)。

システム

  • app: アプリの起動/終了/再起動/非表示/表示/切り替え/一覧表示を行います。
  • clipboard: クリップボードの読み取り/書き込みを行います (テキスト/画像/ファイル)。
  • dialog: システムダイアログのクリック/入力/ファイル選択/閉じる/一覧表示を行います。
  • dock: Dock アイテムの起動/右クリック/非表示/表示/一覧表示を行います。
  • menu: アプリケーションメニュー + メニューエクストラをクリック/一覧表示します。
  • menubar: ステータスバーアイテムを一覧表示/クリックします。
  • open: アプリのターゲット指定 + JSON ペイロードを備えた拡張 open コマンドです。
  • space: スペースの一覧表示/切り替え/ウィンドウ移動を行います。
  • visualizer: Peekaboo の視覚フィードバックアニメーションを試します。
  • window: ウィンドウの閉じる/最小化/最大化/移動/サイズ変更/フォーカス/一覧表示を行います。

ビジョン

  • see: 注釈付き UI マップ、スナップショット ID、オプションの分析を表示します。

グローバルランタイムフラグ

  • --json/-j、--verbose/-v、--log-level <level>
  • --no-remote、--bridge-socket <path>

クイックスタート (ハッピーパス)

peekaboo permissions
peekaboo list apps --json
peekaboo see --annotate --path /tmp/peekaboo-see.png
peekaboo click --on B1
peekaboo type "Hello" --return

共通のターゲット指定パラメーター (ほとんどのインタラクションコマンド)

  • アプリ/ウィンドウ: --app、--pid、--window-title、--window-id、--window-index
  • スナップショットのターゲット指定: --snapshot (see からの ID; デフォルトは最新)
  • 要素/座標: --on/--id (要素 ID)、--coords x,y
  • フォーカス制御: --no-auto-focus、--space-switch、--bring-to-current-space、 --focus-timeout-seconds、--focus-retry-count

共通のキャプチャパラメーター

  • 出力: --path、--format png|jpg、--retina
  • ターゲット指定: --mode screen|window|frontmost、--screen-index、 --window-title、--window-id
  • 分析: --analyze "prompt"、--annotate
  • キャプチャエンジン: --capture-engine auto|classic|cg|modern|sckit

共通の動作/タイピングパラメーター

  • タイミング: --duration (ドラッグ/スワイプ)、--steps、--delay (タイプ/スクロール/プレス)
  • 人間らしい動き: --profile human|linear、--wpm (タイピング)
  • スクロール: --direction up|down|left|right、--amount <ticks>、--smooth

例

See -> click -> type (最も信頼性の高いフロー)

peekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
peekaboo click --on B3 --app Safari
peekaboo type "user@example.com" --app Safari
peekaboo press tab --count 1 --app Safari
peekaboo type "supersecret" --app Safari --return

ウィンドウ ID でターゲット指定

peekaboo list windows --app "Visual Studio Code" --json
peekaboo click --window-id 12345 --coords 120,160
peekaboo type "Hello from Peekaboo" --window-id 12345

スクリーンショットのキャプチャ + 分析

peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
peekaboo image --app Safari --window-title "Dashboard" --analyze "Summarize KPIs"
peekaboo see --mode screen --screen-index 0 --analyze "Summarize the dashboard"

ライブキャプチャ (動きを認識)

peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \
  --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture

アプリ + ウィンドウ管理

peekaboo app launch "Safari" --open https://example.com
peekaboo window focus --app Safari --window-title "Example"
peekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800
peekaboo app quit --app Safari

メニュー、メニューバー、Dock

peekaboo menu click --app Safari --item "New Window"
peekaboo menu click --app TextEdit --path "Format > Font > Show Fonts"
peekaboo menu click-extra --title "WiFi"
peekaboo dock launch Safari
peekaboo menubar list --json

マウス + ジェスチャー入力

peekaboo move 500,300 --smooth
peekaboo drag --from B1 --to T2
peekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800
peekaboo scroll --direction down --amount 6 --smooth

キーボード入力

peekaboo hotkey --keys "cmd,shift,t"
peekaboo press escape
peekaboo type "Line 1\nLine 2" --delay 10

注記

  • 画面収録とアクセシビリティの権限が必要です。
  • クリックする前にターゲットを特定するには、peekaboo see --annotate を使用してください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Peekaboo

Peekaboo is a full macOS UI automation CLI: capture/inspect screens, target UI elements, drive input, and manage apps/windows/menus. Commands share a snapshot cache and support --json/-j for scripting. Run peekaboo or peekaboo <cmd> --help for flags; peekaboo --version prints build metadata. Tip: run via polter peekaboo to ensure fresh builds.

Features (all CLI capabilities, excluding agent/MCP)

Core

  • bridge: inspect Peekaboo Bridge host connectivity
  • capture: live capture or video ingest + frame extraction
  • clean: prune snapshot cache and temp files
  • config: init/show/edit/validate, providers, models, credentials
  • image: capture screenshots (screen/window/menu bar regions)
  • learn: print the full agent guide + tool catalog
  • list: apps, windows, screens, menubar, permissions
  • permissions: check Screen Recording/Accessibility status
  • run: execute .peekaboo.json scripts
  • sleep: pause execution for a duration
  • tools: list available tools with filtering/display options

Interaction

  • click: target by ID/query/coords with smart waits
  • drag: drag & drop across elements/coords/Dock
  • hotkey: modifier combos like cmd,shift,t
  • move: cursor positioning with optional smoothing
  • paste: set clipboard -> paste -> restore
  • press: special-key sequences with repeats
  • scroll: directional scrolling (targeted + smooth)
  • swipe: gesture-style drags between targets
  • type: text + control keys (--clear, delays)

System

  • app: launch/quit/relaunch/hide/unhide/switch/list apps
  • clipboard: read/write clipboard (text/images/files)
  • dialog: click/input/file/dismiss/list system dialogs
  • dock: launch/right-click/hide/show/list Dock items
  • menu: click/list application menus + menu extras
  • menubar: list/click status bar items
  • open: enhanced open with app targeting + JSON payloads
  • space: list/switch/move-window (Spaces)
  • visualizer: exercise Peekaboo visual feedback animations
  • window: close/minimize/maximize/move/resize/focus/list

Vision

  • see: annotated UI maps, snapshot IDs, optional analysis

Global runtime flags

  • --json/-j, --verbose/-v, --log-level <level>
  • --no-remote, --bridge-socket <path>

Quickstart (happy path)

peekaboo permissions
peekaboo list apps --json
peekaboo see --annotate --path /tmp/peekaboo-see.png
peekaboo click --on B1
peekaboo type "Hello" --return

Common targeting parameters (most interaction commands)

  • App/window: --app, --pid, --window-title, --window-id, --window-index
  • Snapshot targeting: --snapshot (ID from see; defaults to latest)
  • Element/coords: --on/--id (element ID), --coords x,y
  • Focus control: --no-auto-focus, --space-switch, --bring-to-current-space, --focus-timeout-seconds, --focus-retry-count

Common capture parameters

  • Output: --path, --format png|jpg, --retina
  • Targeting: --mode screen|window|frontmost, --screen-index, --window-title, --window-id
  • Analysis: --analyze "prompt", --annotate
  • Capture engine: --capture-engine auto|classic|cg|modern|sckit

Common motion/typing parameters

  • Timing: --duration (drag/swipe), --steps, --delay (type/scroll/press)
  • Human-ish movement: --profile human|linear, --wpm (typing)
  • Scroll: --direction up|down|left|right, --amount <ticks>, --smooth

Examples

See -> click -> type (most reliable flow)

peekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
peekaboo click --on B3 --app Safari
peekaboo type "user@example.com" --app Safari
peekaboo press tab --count 1 --app Safari
peekaboo type "supersecret" --app Safari --return

Target by window id

peekaboo list windows --app "Visual Studio Code" --json
peekaboo click --window-id 12345 --coords 120,160
peekaboo type "Hello from Peekaboo" --window-id 12345

Capture screenshots + analyze

peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
peekaboo image --app Safari --window-title "Dashboard" --analyze "Summarize KPIs"
peekaboo see --mode screen --screen-index 0 --analyze "Summarize the dashboard"

Live capture (motion-aware)

peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \
  --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture

App + window management

peekaboo app launch "Safari" --open https://example.com
peekaboo window focus --app Safari --window-title "Example"
peekaboo window set-bounds --app Safari --x 50 --y 50 --width 1200 --height 800
peekaboo app quit --app Safari

Menus, menubar, dock

peekaboo menu click --app Safari --item "New Window"
peekaboo menu click --app TextEdit --path "Format > Font > Show Fonts"
peekaboo menu click-extra --title "WiFi"
peekaboo dock launch Safari
peekaboo menubar list --json

Mouse + gesture input

peekaboo move 500,300 --smooth
peekaboo drag --from B1 --to T2
peekaboo swipe --from-coords 100,500 --to-coords 100,200 --duration 800
peekaboo scroll --direction down --amount 6 --smooth

Keyboard input

peekaboo hotkey --keys "cmd,shift,t"
peekaboo press escape
peekaboo type "Line 1\nLine 2" --delay 10

Notes

  • Requires Screen Recording + Accessibility permissions.
  • Use peekaboo see --annotate to identify targets before clicking.