Skip to content

Commit 4386de5

Browse files
committed
Update agent-device skill docs for deep-link open
1 parent 254ad67 commit 4386de5

1 file changed

Lines changed: 9 additions & 5 deletions

File tree

skills/agent-device/SKILL.md

Lines changed: 9 additions & 5 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` 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)
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
@@ -41,8 +41,10 @@ npx -y agent-device
4141
agent-device boot # Ensure target is booted/ready without opening app
4242
agent-device boot --platform ios # Boot iOS simulator
4343
agent-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
4648
agent-device close [app] # Close app or just end session
4749
agent-device reinstall <app> <path> # Uninstall + install app in one command
4850
agent-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

Comments
 (0)