peekaboo tools
peekaboo tools prints the authoritative tool catalog that the CLI, Peekaboo.app, and MCP server expose. The command hydrates the native tool set (Image, See, Click, Window, etc.) so you can audit everything an agent will see without attaching a debugger.
#Key options
| Flag | Description |
|---|---|
--no-sort | Preserve registration order instead of alphabetizing every tool. |
--json | Emit {tools:[…], count:n} for machine parsing. |
#Implementation notes
- The command instantiates every native
MCPToolmanually (ImageTool, ClickTool, DialogTool, etc.) so you see the same tool set the agent runtime will use. - Filtering happens before formatting (
ToolFiltering.apply), so allow/deny rules match the agent + MCP server behavior. - The command runs locally by default because it only reports the static native catalog; pass
--bridge-socket <path>only when you need to inspect a specific bridge host. - Because the command implements
RuntimeOptionsConfigurable, it respects global--json/--verboseflags even when invoked from other commands (e.g.,peekaboo learncan embed the summaries verbatim).
#Examples
# Produce a JSON blob for an agent integration test
peekaboo tools --json > /tmp/tools.json
#Troubleshooting
- Verify Screen Recording + Accessibility permissions (
peekaboo permissions status). - Confirm your target (app/window/selector) with
peekaboo list/peekaboo seebefore rerunning. - Re-run with
--jsonor--verboseto surface detailed errors.