Global Options
These flags can be added to any agent-click command.
Output format
| Flag | Description |
|---|---|
| (default) | JSON output |
--human | Human-readable output |
--compact | Compact single-line JSON |
agent-click click @e5 # {"success": true, "message": "pressed ..."}
agent-click click @e5 --human # pressed "7" at (453, 354)
agent-click click @e5 --compact # {"success":true,"message":"pressed ..."}Timeout
agent-click wait-for 'name="Dashboard"' --timeout 15 agent-click click @e5 --expect 'name="Done"' --timeout 10
Default: 5 seconds. Applies to wait-for, --expect, and element polling.
Verbose
agent-click click @e5 -v
Shows debug traces: selector resolution, element lookup, timing, CDP connection status.
CDP flags
| Flag | Description |
|---|---|
--cdp | Force CDP mode (even for non-Electron apps) |
--cdp-port <port> | Override the auto-detected CDP port |
--no-cdp | Disable CDP entirely, use native accessibility only |
CDP is automatic for Electron apps — you rarely need these flags. They're power-user overrides.
agent-click snapshot -a Slack -i -c # auto-detects Electron, uses CDP agent-click snapshot -a MyApp --cdp --cdp-port 9222 # force CDP with specific port agent-click snapshot -a Slack --no-cdp # disable CDP, native only