Peekaboo/docs/commands

summary	read_when
Index of Peekaboo CLI command docs	browsing available Peekaboo CLI commands linking to specific command docs

Command docs index

Core automation

• agent.md — run the autonomous agent loop.
• app.md — launch/quit/focus apps.
• open.md — open files/URLs with focus controls.
• window.md — move/resize/focus windows.
• menu.md, menubar.md — drive app menus and status items.
• click.md, move.md, scroll.md, swipe.md, drag.md, press.md, type.md, set-value.md, perform-action.md, hotkey.md, sleep.md — input primitives.
• see.md, image.md, capture.md — screenshots, annotated UI maps, capture sessions.

System & config

• config.md, permissions.md, bridge.md, daemon.md, tools.md, clean.md, run.md, learn.md, list.md.
• completions.md — install shell-native completions for zsh, bash, and fish.
• MCP helpers: mcp.md.
• Clipboard: clipboard.md.

Reference tips

• Each command page lists flags, examples, and troubleshooting. For common pitfalls (permissions, focus, window targeting), see the “Common troubleshooting” section below.

Common troubleshooting

• Background/foreground issues — input commands use background delivery when they can resolve a target process. Element/query clicks can use Accessibility actions; grant Event Synthesizing for keyboard input, coordinates, and click fallback, or pass --foreground and ensure the target app/window is focused.
• Element not found — run peekaboo see --annotate to verify AX labels/roles; fall back to coordinates with --coords when needed.
• Permission errors — re-run peekaboo permissions grant and restart affected apps if dialogs persist.
• Slow or flaky automation — add --quiet-ms/--heartbeat-sec for capture/live commands; for input commands use --delay where available or precede with sleep.