openclaw/peekaboo
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
PeekabooはmacOSのCLIおよびオプションのMCPサーバーで、AIエージェントがアプリケーションやシステム全体のスクリーンショットをキャプチャし、ローカルまたはリモートのAIによる視覚的な質問応答も可能にします...
概要
Peekabooは高忠実度のスクリーンキャプチャ、AI分析、完全なGUI自動化をmacOSに提供します。バージョン3では、CLIおよびMCPサーバー全体でネイティブエージェントフローとマルチスクリーン自動化が追加されました。 - ピクセル単位で正確なキャプチャ(ウィンドウ、画面、メニューバー)を可能に、オプションでRetinaの2倍スケーリングを可能。- Peekabooツール(参照、クリック、タイプ、スクロール、ホットキー、メニュー、ウィンドウ、アプリ、ドック、スペース)を連鎖する自然言語エージェント。- ターゲットが分かればデフォルトでバックグラウンドプロセスターゲット入力をする、ルーチンクリック/スクロールのためのアクション優先のUI自動化。- 設定可能な値や名前付きアクション(set-value、perform-action)のための直接アクセシビリティツール。- 構造化されたJSONによるメニューおよびメニューバーの発見;クリック不要。- Tachikomaを通じたマルチプロバイダーAI(ホスト、ローカル、OpenAI/Anthropic互換プロバイダーを含む)。- Claude Fable 5のサポート、1Mコンテキストと128Kの出力上限;保存された温度/最大トークン設定はアプリとCLIで共有され、各モデルの性能に合わせて固定されます。
概要（AI 翻訳）
Peekabooは、スクリーンキャプチャ、アクセシビリティ検査、ネイティブUI自動化のためのmacOSのCLIおよびメニューバーアプリです。直接使用するか、エージェントに多段階作業の計画を任せ、同じツールセットをMCPクライアントに公開しても構いません。
インストール
リリースされたCLIとアプリはmacOS 15以降が必要です。
HomebrewでのCLIです
NPM付きのMCPパッケージ
npmパッケージはNode.js 22以上が必要で、CLIとMCPランチャーが含まれています。
Codex、Claude Code、Cursor、または他のMCPクライアントに接続するには、MCPの設定を参照してください。
Macアプリ
最新のGitHubリリースから署名済みDMGをダウンロードしてください。メニューバーアプリは権限オンボーディング、視覚的フィードバック、エージェントセッションを提供します。peekabooもPATHに必要であれば、CLIを別途インストールしてください。
ソースビルドや代替インストールの詳細については、インストールガイドをご覧ください。
クイックスタート
Peekabooの許可を確認し、スクリーンショットを撮ります:
スクリーンキャプチャには画面録画権限が必要です。アクセシビリティ権限はUIの検査と制御を可能にします。権限ガイドはセットアップと合成入力に追加権限の使用をカバーしています。
実行中のアプリを検査して、不透明な要素IDを持つ構造化されたUIマップを取得します:
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
Peekaboo 🫣 — Mac automation that sees the screen and does the clicks.
Peekaboo is a macOS CLI and menu-bar app for screen capture, accessibility inspection, and native UI automation. Use it directly, let its agent plan multi-step work, or expose the same toolset to MCP clients.
Install
The released CLI and app require macOS 15 or later.
CLI with Homebrew
brew install openclaw/tap/peekaboo
MCP package with npm
The npm package requires Node.js 22 or later and includes the CLI plus its MCP launcher.
npx -y @steipete/peekaboo --version
See MCP setup to connect it to Codex, Claude Code, Cursor, or another MCP client.
Mac app
Download the signed DMG from the latest GitHub release. The menu-bar app provides permission onboarding, visual feedback, and agent sessions; install the CLI separately when you also need peekaboo on PATH.
For source builds and alternative install details, see the installation guide.
Quick start
Check the permissions available to Peekaboo, then take a screenshot:
peekaboo permissions status
peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png
Screen capture requires Screen Recording permission. Accessibility permission enables UI inspection and control; the permissions guide covers setup and the additional permission used for synthetic input.
Inspect a running app to get a structured UI map with opaque element IDs:
peekaboo see --app Finder --json
That is the core loop: observe the current screen, choose an element from the result, and act on it.
インストール
npx -y @steipete/peekaboo --version