openclaw/peekaboo
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Peekaboo는 macOS CLI이자 선택적 MCP 서버로, AI 에이전트가 애플리케이션이나 전체 시스템의 스크린샷을 캡처할 수 있게 해주며, 로컬 또는 원격 AI를 통한 시각적 질문 답변도 선택할 수 있습니다...
개요
Peekaboo는 macOS에 고해상도 화면 캡처, AI 분석, 완전한 GUI 자동화를 제공합니다. 버전 3에서는 CLI와 MCP 서버 전반에 걸쳐 네이티브 에이전트 플로우와 다중 화면 자동화가 추가되었습니다. - 픽셀 정확도 캡처(창, 화면, 메뉴 바)와 선택적 Retina 2배 스케일링. - 피카부 도구(보기, 클릭, 타이핑, 스크롤, 단축키, 메뉴, 창, 앱, 독, 공간)를 연쇄 연결하는 자연어 에이전트. - 일상적인 클릭/스크롤을 위한 액션 우선 UI 자동화, 목표가 알려지면 기본적으로 백그라운드 프로세스 타겟팅 입력. - 설정 가능한 값과 이름 있는 액션(set-value, perform-action)을 위한 직접 접근성 도구. - 구조화된 JSON을 통한 메뉴 및 메뉴바 발견; 클릭이 필요 없음. - Tachikoma를 통한 다중 공급자 AI, 호스팅, 로컬, OpenAI/Anthropic 호환 제공자를 포함. - Claude Fable 5 지원, 1M 컨텍스트와 128K 출력 상한; 저장된 온도/최대 토큰 설정은 앱과 CLI에서 공유되며 각 모델의 기능에 맞춰 고정됩니다.
개요(AI 번역)
Peekaboo는 macOS용 CLI 및 메뉴바 앱으로, 화면 캡처, 접근성 검사, 네이티브 UI 자동화를 지원합니다. 직접 사용하거나, 에이전트가 다단계 작업을 계획하도록 하거나, 동일한 툴셋을 MCP 클라이언트에게 노출할 수 있습니다.
설치
출시된 CLI와 앱은 macOS 15 이상이 필요합니다.
홈브루와 함께하는 CLI
NPM이 포함된 MCP 패키지
npm 패키지는 Node.js 22 이상을 요구하며, CLI와 MCP 런처를 포함합니다.
Codex, Claude Code, 커서 또는 다른 MCP 클라이언트에 연결하려면 MCP 설정을 참고하세요.
맥 앱
최신 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