bcharleson/grokbot-peekaboo/peekaboo

Enhance local Mac exec with Peekaboo

A Grok Bot already has a cloud computer. It can also control the user registered local computers.

ListMachines, then Shell with that machineId, is normal bash. That works without Peekaboo.

Peekaboo is the enhancement on each Mac: screen recording, screenshots, window lists, and UI input. Same local-exec path. Works from the Grok Bot iOS app too, because the Mac runs the commands.

This skill is not Peekaboo. Install Peekaboo from upstream, then save this skill on the bot.

Source (Peekaboo)

Official install: https://github.com/openclaw/Peekaboo/blob/main/docs/install.md Permissions: https://github.com/openclaw/Peekaboo/blob/main/docs/permissions.md Released CLI and app need macOS 15+.

Give this skill to a Grok Bot

Tell the target bot: save this as a private skill from https://raw.githubusercontent.com/bcharleson/grokbot-peekaboo/main/skills/peekaboo/SKILL.md

Or Settings, Plugins, Yours, Private skills. Keep the YAML name and description.

Install Peekaboo on each registered Mac

Do not install Peekaboo on Grok Bot Linux computer. Do not add it as a Grok Bot MCP.

brew install steipete/tap/peekaboo peekaboo --version

Also install Peekaboo.app from the signed DMG on the latest GitHub release. The app is the permission host. The CLI is what the bot runs over local exec.

If Homebrew fails on stale Xcode CLT, use peekaboo-macos-universal.tar.gz from Releases. Put peekaboo on PATH. Do not run sudo xcode-select --install just for brew.

What bash already does

Files, git, brew, process lists, opening Privacy panes with open. Stay in the path the user named. Do not scan HOME, Desktop, Documents, or Downloads.

What Peekaboo adds

Screen recording, screenshots, window titles, and UI input. Grant Screen Recording plus Accessibility on Peekaboo.app and/or the peekaboo CLI row.

Check both hosts before deciding the machine is broken:

peekaboo permissions --json peekaboo permissions --json --no-remote

If local is granted and the app is not, pass --no-remote on every later command. v4: peekaboo window list --app Finder --json --no-remote

Shots back to chat

screencapture -x needs Screen Recording on Grok Bot. CopyToBox cannot read /tmp. Capture into a user-named folder, CopyToBox, attach, then rm the Mac copy.

UI writes

Do not drive the desktop unless the user asked. Confirm before any UI write.

Do not

• Add Peekaboo via AddMcpServer on Grok Bot (runs on Linux, useless).
• Quote secrets from a screenshot.
• Run sudo xcode-select --install just to satisfy brew.