Skip to content

Commit 8332238

Browse files
committed
Clarify open vs boot fallback guidance
1 parent caf9bba commit 8332238

2 files changed

Lines changed: 3 additions & 3 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,7 @@ Boot diagnostics:
195195
- Boot failures include normalized reason codes in `error.details.reason` (JSON mode) and verbose logs.
196196
- Reason codes: `IOS_BOOT_TIMEOUT`, `IOS_RUNNER_CONNECT_TIMEOUT`, `ANDROID_BOOT_TIMEOUT`, `ADB_TRANSPORT_UNAVAILABLE`, `CI_RESOURCE_STARVATION_SUSPECTED`, `BOOT_COMMAND_FAILED`, `UNKNOWN`.
197197
- Android boot waits fail fast for permission/tooling issues and do not always collapse into timeout errors.
198-
- Use `agent-device boot --platform ios|android` when starting a new session only if `open` fails because no booted target is available.
198+
- Use `agent-device boot --platform ios|android` when starting a new session only if `open` cannot find/connect to an available target.
199199
- Set `AGENT_DEVICE_RETRY_LOGS=1` to print structured retry telemetry (attempt, phase, delay, elapsed/remaining deadline, reason).
200200

201201
## App resolution

skills/agent-device/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ npx -y agent-device
2727

2828
## Core workflow
2929

30-
1. Open app: `open [app]` (open boots/activates the selected target when needed)
30+
1. Open app: `open [app]` (`open` handles target selection + boot/activation in the normal flow)
3131
2. Snapshot: `snapshot` to get refs from accessibility tree
3232
3. Interact using refs (`click @ref`, `fill @ref "text"`)
3333
4. Re-snapshot after navigation/UI changes
@@ -49,7 +49,7 @@ agent-device session list # List active sessions
4949
```
5050

5151
`boot` requires either an active session or an explicit selector (`--platform`, `--device`, `--udid`, or `--serial`).
52-
Use `boot` when starting a new session only if `open` fails because no booted target is available.
52+
`boot` is a fallback, not a regular step: use it when starting a new session only if `open` cannot find/connect to an available target.
5353

5454
### Snapshot (page analysis)
5555

0 commit comments

Comments
 (0)