File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -119,8 +119,6 @@ Sessions:
119119- All interaction commands require an open session.
120120- If a session is already open, ` open <app> ` switches the active app and updates the session app bundle.
121121- ` close ` stops the session and releases device resources. Pass an app to close it explicitly, or omit to just close the session.
122- - ` reinstall <app> <path> ` uninstalls and installs the app binary in one command (Android + iOS simulator in v1).
123- - ` reinstall ` accepts package/bundle id style app names and supports ` ~ ` in paths.
124122- Use ` --session <name> ` to manage multiple sessions.
125123- Session scripts are written to ` ~/.agent-device/sessions/<session>-<timestamp>.ad ` when recording is enabled with ` --save-script ` .
126124- Deterministic replay is ` .ad ` -based; use ` replay --update ` (` -u ` ) to update selector drift and rewrite the replay file in place.
Original file line number Diff line number Diff line change @@ -169,10 +169,8 @@ agent-device apps --platform android --user-installed
169169- On iOS, ` xctest ` is the default and does not require Accessibility permission.
170170- If XCTest returns 0 nodes (foreground app changed), agent-device falls back to AX when available.
171171- ` open <app> ` can be used within an existing session to switch apps and update the session bundle id.
172- - ` reinstall <app> <path> ` supports Android devices/emulators and iOS simulators in v1.
173172- If AX returns the Simulator window or empty tree, restart Simulator or use ` --backend xctest ` .
174173- Use ` --session <name> ` for parallel sessions; avoid device contention.
175- - Use ` boot --platform ios|android ` as explicit preflight in CI before ` open ` .
176174- Use ` --activity <component> ` on Android to launch a specific activity (e.g. TV apps with LEANBACK).
177175- Use ` fill ` when you want clear-then-type semantics.
178176- Use ` type ` when you want to append/enter text without clearing.
Original file line number Diff line number Diff line change 33## Named sessions
44
55``` bash
6- agent-device boot --platform ios
76agent-device --session auth open Settings --platform ios
8- agent-device --session auth reinstall com.example.app ./build/MyApp.app
97agent-device --session auth snapshot -i
108```
119
@@ -16,8 +14,6 @@ Sessions isolate device context. A device can only be held by one session at a t
1614- Name sessions semantically.
1715- Close sessions when done.
1816- Use separate sessions for parallel work.
19- - Use ` boot --platform ios|android ` as an explicit readiness check in CI.
20- - Use ` reinstall <app> <path> ` for fresh app state instead of manual logout flows.
2117- For deterministic replay scripts, prefer selector-based actions and assertions.
2218- Use ` replay -u ` to update selector drift during maintenance.
2319
Original file line number Diff line number Diff line change @@ -7,9 +7,6 @@ title: Quick Start
77Every device automation follows this pattern:
88
99``` bash
10- # 0. Optional CI/device preflight
11- agent-device boot --platform ios # or android
12-
1310# 1. Navigate
1411agent-device open SampleApp --platform ios # or android
1512
@@ -35,13 +32,10 @@ agent-device boot --platform ios # or android
3532## Common commands
3633
3734``` bash
38- agent-device boot --platform ios # Ensure simulator/device is ready
3935agent-device open SampleApp
4036agent-device snapshot -i # Get interactive elements with refs
4137agent-device click @e2 # Click by ref
4238agent-device fill @e3 " test@example.com" # Clear then type (Android verifies and retries once if needed)
43- agent-device reinstall com.example.app ./build/MyApp.app --platform ios # Fresh app state (iOS simulator)
44- agent-device reinstall com.example.app ./build/app.apk --platform android # Fresh app state (Android)
4539agent-device get text @e1 # Get text content
4640agent-device screenshot page.png # Save to specific path
4741agent-device close
Original file line number Diff line number Diff line change @@ -7,7 +7,6 @@ title: Sessions
77Sessions keep device state and snapshots consistent across commands.
88
99``` bash
10- agent-device boot --platform ios
1110agent-device open Settings --platform ios
1211agent-device session list
1312agent-device open Contacts # change app while reusing the default session
2625
2726- ` open <app> ` within an existing session switches the active app and updates the session bundle id.
2827- Use ` --session <name> ` to run multiple sessions in parallel.
29- - Use ` boot --platform ios|android ` as an explicit readiness preflight in CI.
30- - Use ` reinstall <app> <path> ` when you need a fresh app state (for example login flows) without manual logout.
3128
3229For replay scripts and deterministic E2E guidance, see [ Replay & E2E (Experimental)] ( /docs/replay-e2e ) .
You can’t perform that action at this time.
0 commit comments