@@ -27,7 +27,7 @@ npx -y agent-device
2727
2828## Core workflow
2929
30- 1 . Open app: ` open [app] ` (` open ` handles target selection + boot/activation in the normal flow)
30+ 1 . Open app or deep link : ` open [app|url ] ` (` open ` handles target selection + boot/activation in the normal flow)
31312 . Snapshot: ` snapshot ` to get refs from accessibility tree
32323 . Interact using refs (` click @ref ` , ` fill @ref "text" ` )
33334 . Re-snapshot after navigation/UI changes
@@ -41,8 +41,10 @@ npx -y agent-device
4141agent-device boot # Ensure target is booted/ready without opening app
4242agent-device boot --platform ios # Boot iOS simulator
4343agent-device boot --platform android # Boot Android emulator/device target
44- agent-device open [app] # Boot device/simulator; optionally launch app
45- agent-device open [app] --activity com.example/.MainActivity # Android: open specific activity
44+ agent-device open [app| url] # Boot device/simulator; optionally launch app or deep link URL
45+ agent-device open [app] --activity com.example/.MainActivity # Android: open specific activity (app targets only)
46+ agent-device open " myapp://home" --platform android # Android deep link
47+ agent-device open " https://example.com" --platform ios # iOS simulator deep link
4648agent-device close [app] # Close app or just end session
4749agent-device reinstall < app> < path> # Uninstall + install app in one command
4850agent-device session list # List active sessions
@@ -168,10 +170,12 @@ agent-device apps --platform android --user-installed
168170- Prefer ` snapshot -i ` to reduce output size.
169171- On iOS, ` xctest ` is the default and does not require Accessibility permission.
170172- If XCTest returns 0 nodes (foreground app changed), agent-device falls back to AX when available.
171- - ` open <app> ` can be used within an existing session to switch apps and update the session bundle id.
173+ - ` open <app|url> ` can be used within an existing session to switch apps or open deep links.
174+ - ` open <app> ` updates session app bundle context; URL opens do not set an app bundle id.
172175- If AX returns the Simulator window or empty tree, restart Simulator or use ` --backend xctest ` .
173176- Use ` --session <name> ` for parallel sessions; avoid device contention.
174- - Use ` --activity <component> ` on Android to launch a specific activity (e.g. TV apps with LEANBACK).
177+ - Use ` --activity <component> ` on Android to launch a specific activity (e.g. TV apps with LEANBACK); do not combine with URL opens.
178+ - iOS deep-link opens are simulator-only in v1.
175179- Use ` fill ` when you want clear-then-type semantics.
176180- Use ` type ` when you want to append/enter text without clearing.
177181- On Android, prefer ` fill ` for important fields; it verifies entered text and retries once when IME reorders characters.
0 commit comments