peekaboo daemon

Manage the on-demand headless daemon that keeps Peekaboo state warm, tracks windows live, and serves bridge requests.

#Commands

#Start

peekaboo daemon start

Options:

• --bridge-socket <path> override the default bridge socket path.
• --poll-interval-ms <ms> window tracker poll interval (default 1000ms).
• --wait-seconds <sec> how long to wait for startup (default 3s).

#Status

peekaboo daemon status

Shows:

• running state + PID
• bridge socket + host kind
• permissions (screen recording / accessibility / automation)
• snapshot cache summary
• window tracker stats (tracked windows, last event, polling)

#Stop

peekaboo daemon stop

Options:

• --bridge-socket <path> override the default bridge socket path.
• --wait-seconds <sec> how long to wait for shutdown (default 3s).

#Notes

• peekaboo mcp always runs in daemon mode.
• The daemon uses an in-memory snapshot store for speed.
• For local development with unsigned binaries, set PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1.