Quick Start
Automate your first app in 60 seconds.
1
Open an app
agent-click open Calculator --wait
The --wait flag ensures the app is fully loaded before continuing.
2
Take a snapshot
agent-click snapshot -a Calculator -i -c
This shows all interactive elements with refs:
application "Calculator"
window "Calculator"
[@e1] button "Delete" id=Delete
[@e2] button "All Clear" id=AllClear
[@e3] button "7" id=Seven
[@e4] button "8" id=Eight
[@e5] button "9" id=Nine
...
3
Interact
agent-click click 'id="AllClear"' -a Calculator agent-click click 'id="Seven"' -a Calculator agent-click click 'id="Add"' -a Calculator agent-click click 'id="Eight"' -a Calculator agent-click click 'id="Equals"' -a Calculator
4
Read the result
agent-click text -a Calculator | grep -A1 "Edit field" # → 15
What just happened?
- No mouse moved. Clicks used AXPress (accessibility action).
- No window activated. Calculator stayed in the background.
- No coordinates. Elements targeted by ID.
- 15ms per click. Native accessibility API, zero overhead.
Next steps
- Selectors — target elements by role, name, ID, or CSS
- Commands — full reference for all 25 commands
- Background Ops — understand headless vs focus-required actions