Loading...
Loading...
Automates mobile and simulator interactions for iOS and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info on mobile devices or simulators.
npx skill4agent add callstackincubator/agent-device agent-deviceagent-device open Settings --platform ios
agent-device snapshot -i
agent-device click @e3
agent-device wait text "Camera"
agent-device alert wait 10000
agent-device fill @e5 "test"
agent-device closenpx -y agent-deviceopen [app]snapshotclick @reffill @ref "text"agent-device open [app] # Boot device/simulator; optionally launch app
agent-device close [app] # Close app or just end session
agent-device session list # List active sessionsagent-device snapshot # Full XCTest accessibility tree snapshot
agent-device snapshot -i # Interactive elements only (recommended)
agent-device snapshot -c # Compact output
agent-device snapshot -d 3 # Limit depth
agent-device snapshot -s "Camera" # Scope to label/identifier
agent-device snapshot --raw # Raw node output
agent-device snapshot --backend xctest # default: XCTest snapshot (fast, complete, no permissions)
agent-device snapshot --backend ax # macOS Accessibility tree (fast, needs permissions, less fidelity, optional)agent-device find "Sign In" click
agent-device find text "Sign In" click
agent-device find label "Email" fill "user@example.com"
agent-device find value "Search" type "query"
agent-device find role button click
agent-device find id "com.example:id/login" click
agent-device find "Settings" wait 10000
agent-device find "Settings" existsagent-device settings wifi on
agent-device settings wifi off
agent-device settings airplane on
agent-device settings airplane off
agent-device settings location on
agent-device settings location offagent-device appstate
agent-device apps --metadata --platform ios
agent-device apps --metadata --platform androidagent-device click @e1
agent-device focus @e2
agent-device fill @e2 "text" # Tap then type
agent-device type "text" # Type into focused field
agent-device press 300 500 # Tap by coordinates
agent-device long-press 300 500 800 # Long press (where supported)
agent-device scroll down 0.5
agent-device back
agent-device home
agent-device app-switcher
agent-device wait 1000
agent-device wait text "Settings"
agent-device alert getagent-device get text @e1
agent-device get attrs @e1
agent-device screenshot --out out.pngagent-device trace start # Start trace capture
agent-device trace start ./trace.log # Start trace capture to path
agent-device trace stop # Stop trace capture
agent-device trace stop ./trace.log # Stop and move trace logagent-device devices
agent-device apps --platform ios
agent-device apps --platform android # default: launchable only
agent-device apps --platform android --all
agent-device apps --platform android --user-installedsnapshot -ixctestopen <app>--backend xctest--session <name>