Document boot and reinstall in website docs and skill

Author: thymikee

skills/agent-device/SKILL.md

@@ -27,23 +27,31 @@ npx -y agent-device
 
 ## Core workflow
 
-1. Open app or just boot device: `open [app]`
-2. Snapshot: `snapshot` to get refs from accessibility tree
-3. Interact using refs (`click @ref`, `fill @ref "text"`)
-4. Re-snapshot after navigation/UI changes
-5. Close session when done
+1. Optional preflight in CI: `boot --platform ios|android`
+2. Open app or just boot device: `open [app]`
+3. Use `reinstall <app> <path>` when you need fresh app state before testing auth/onboarding flows
+4. Snapshot: `snapshot` to get refs from accessibility tree
+5. Interact using refs (`click @ref`, `fill @ref "text"`)
+6. Re-snapshot after navigation/UI changes
+7. Close session when done
 
 ## Commands
 
 ### Navigation
 
 ```bash
+agent-device boot                 # Ensure target is booted/ready without opening app
+agent-device boot --platform ios  # CI preflight for iOS simulator
+agent-device boot --platform android # CI preflight for Android device/emulator
 agent-device open [app]           # Boot device/simulator; optionally launch app
 agent-device open [app] --activity com.example/.MainActivity # Android: open specific activity
 agent-device close [app]          # Close app or just end session
+agent-device reinstall <app> <path> # Uninstall + install app in one command
 agent-device session list         # List active sessions
 ```
 
+`boot` requires either an active session or an explicit selector (`--platform`, `--device`, `--udid`, or `--serial`).
+
 ### Snapshot (page analysis)
 
 ```bash
@@ -162,8 +170,10 @@ agent-device apps --platform android --user-installed
 - On iOS, `xctest` is the default and does not require Accessibility permission.
 - If XCTest returns 0 nodes (foreground app changed), agent-device falls back to AX when available.
 - `open <app>` can be used within an existing session to switch apps and update the session bundle id.
+- `reinstall <app> <path>` supports Android devices/emulators and iOS simulators in v1.
 - If AX returns the Simulator window or empty tree, restart Simulator or use `--backend xctest`.
 - Use `--session <name>` for parallel sessions; avoid device contention.
+- Use `boot --platform ios|android` as explicit preflight in CI before `open`.
 - Use `--activity <component>` on Android to launch a specific activity (e.g. TV apps with LEANBACK).
 - Use `fill` when you want clear-then-type semantics.
 - Use `type` when you want to append/enter text without clearing.

skills/agent-device/references/session-management.md

@@ -3,7 +3,9 @@
 ## Named sessions
 
 ```bash
+agent-device boot --platform ios
 agent-device --session auth open Settings --platform ios
+agent-device --session auth reinstall com.example.app ./build/MyApp.app
 agent-device --session auth snapshot -i
 ```
 
@@ -14,6 +16,8 @@ Sessions isolate device context. A device can only be held by one session at a t
 - Name sessions semantically.
 - Close sessions when done.
 - Use separate sessions for parallel work.
+- Use `boot --platform ios|android` as an explicit readiness check in CI.
+- Use `reinstall <app> <path>` for fresh app state instead of manual logout flows.
 - For deterministic replay scripts, prefer selector-based actions and assertions.
 - Use `replay -u` to update selector drift during maintenance.
 

website/docs/docs/commands.md

@@ -9,13 +9,20 @@ This page summarizes the primary command groups.
 ## Navigation
 
 ```bash
+agent-device boot
+agent-device boot --platform ios
+agent-device boot --platform android
 agent-device open [app]
 agent-device close [app]
 agent-device back
 agent-device home
 agent-device app-switcher
 ```
 
+- `boot` ensures the selected target is ready without launching an app.
+- `boot` requires either an active session or an explicit device selector.
+- Use `boot --platform ios|android` for CI preflight checks.
+
 ## Snapshot and inspect
 
 ```bash
@@ -61,6 +68,17 @@ agent-device replay -u ./session.ad   # Update selector drift and rewrite .ad sc
 
 See [Replay & E2E (Experimental)](/docs/replay-e2e) for recording and CI workflow details.
 
+## App reinstall (fresh state)
+
+```bash
+agent-device reinstall com.example.app ./build/app.apk --platform android
+agent-device reinstall com.example.app ./build/MyApp.app --platform ios
+```
+
+- `reinstall <app> <path>` uninstalls and installs in one command.
+- Supports Android devices/emulators and iOS simulators in v1.
+- Useful for login/logout reset flows and deterministic test setup.
+
 ## Settings helpers
 
 ```bash

website/docs/docs/quick-start.md

@@ -7,6 +7,9 @@ title: Quick Start
 Every device automation follows this pattern:
 
 ```bash
+# 0. Optional CI/device preflight
+agent-device boot --platform ios # or android
+
 # 1. Navigate
 agent-device open SampleApp --platform ios # or android
 
@@ -26,10 +29,13 @@ agent-device snapshot -i
 ## Common commands
 
 ```bash
+agent-device boot --platform ios          # Ensure simulator/device is ready
 agent-device open SampleApp
 agent-device snapshot -i                 # Get interactive elements with refs
 agent-device click @e2                   # Click by ref
 agent-device fill @e3 "test@example.com" # Clear then type (Android verifies and retries once if needed)
+agent-device reinstall com.example.app ./build/MyApp.app --platform ios      # Fresh app state (iOS simulator)
+agent-device reinstall com.example.app ./build/app.apk --platform android     # Fresh app state (Android)
 agent-device get text @e1                # Get text content
 agent-device screenshot page.png         # Save to specific path
 agent-device close

website/docs/docs/sessions.md

@@ -7,6 +7,7 @@ title: Sessions
 Sessions keep device state and snapshots consistent across commands.
 
 ```bash
+agent-device boot --platform ios
 agent-device open Settings --platform ios
 agent-device session list
 agent-device open Contacts          # change app while reusing the default session
@@ -25,5 +26,7 @@ Notes:
 
 - `open <app>` within an existing session switches the active app and updates the session bundle id.
 - Use `--session <name>` to run multiple sessions in parallel.
+- Use `boot --platform ios|android` as an explicit readiness preflight in CI.
+- Use `reinstall <app> <path>` when you need a fresh app state (for example login flows) without manual logout.
 
 For replay scripts and deterministic E2E guidance, see [Replay & E2E (Experimental)](/docs/replay-e2e).