Quick Start

    Every device automation follows this pattern:

    # 1. Navigate
agent-device open SampleApp --platform ios # or android

# 2. Snapshot to get element refs
agent-device snapshot -i
# Output:
# @e1 [heading] "Sample App"
# @e2 [button] "Settings"

# 3. Interact using refs
agent-device click @e2

# 4. Re-snapshot before next interactions
agent-device snapshot -i

    Common commands

    agent-device open SampleApp
agent-device snapshot -i                 # Get interactive elements with refs
agent-device click @e2                   # Click by ref
agent-device fill @e3 "[email protected]" # Clear then type (Android verifies and retries once if needed)
agent-device get text @e1                # Get text content
agent-device screenshot page.png         # Save to specific path
agent-device close

    Semantic selectors

    Use find for human-readable targeting without refs:

    agent-device find "Sign In" click
agent-device find label "Email" fill "[email protected]"
agent-device find role button click

    Scrolling

    Navigate content that extends beyond the viewport:

    agent-device scroll down 0.5            # Scroll down half screen
agent-device scroll up 0.3              # Scroll up 30%

    Settings helpers

    Toggle device settings directly:

    agent-device settings wifi on
agent-device settings airplane on
agent-device settings location off

    JSON output

    For programmatic parsing in scripts:

    agent-device snapshot --json
agent-device get text @e1 --json

    Note: The default text output is more compact and preferred for AI agents.

    Need React or React Native expertise you can count on?

    Let's talk