ZeptapDocs

Debug console

A plain-text command port on 127.0.0.1:47800 for inspecting connection state, logs and raw input while developing or debugging Zeptap.

Zeptap listens for one-line text commands on 127.0.0.1:47800 (loopback only). It is for debugging Zeptap itself; agents should use the MCP tools.

printf 'help\n' | nc -w 5 127.0.0.1 47800

Common commands

CommandReturns
helpEvery command
statusBluetooth, screen and pairing state
log [n]The last n Bluetooth events (default 40)
applog [n]The last n app log lines (default 40)
pairedThe paired iPhones
advertiseMakes the Mac discoverable, for pairing a new iPhone
connectReconnects Bluetooth
screen / screenresetScreen capture state / restarts the capture
shot [path]Saves the current frame as PNG (default /tmp/zeptap.png)

Raw input commands (tap, drag, type, key, home, back, …) take coordinates from 0 to 1 rather than screenshot pixels. Run help for their arguments.

On this page