Reference

`peekaboo visualizer`

Home GitHub Edit page

peekaboo visualizer

Runs a lightweight smoke sequence for the three v4 visualizer surfaces: the agent cursor, app-anchored input HUD, and capture indicators.

These are three feedback categories, not the complete settings surface: Peekaboo.app also has a visualizer master switch, a menu-bar app-icons switch, and playback controls.

#What it does

  • Connects to the visualizer host (typically Peekaboo.app)
  • Emits representative cursor, input HUD, and capture-indicator events

#Usage

peekaboo visualizer
peekaboo visualizer --json > .artifacts/playground-tools/visualizer.json

#Notes

  • This is primarily a manual visual check: success means the command exits 0, dispatches all visualizer events, and you can see the overlay sequence render.
  • The smoke command deliberately previews overlays. Production targeted background input never emits cursor or input-HUD overlays, even when the target window is visible or frontmost; only untargeted or explicitly foreground input may show them.
  • If the visualizer host is not available, the command fails fast instead of pacing through the full animation sequence.
  • If nothing appears, verify:
  • Peekaboo.app is running and reachable
  • permissions are granted (peekaboo permissions status)
  • your screen isn’t being captured by another app that blocks overlays