Skip to content

Commit c98897a

Browse files
committed
docs(sessions): document saved open surfaces with the open --surface flag
1 parent 87a4b1a commit c98897a

2 files changed

Lines changed: 1 addition & 1 deletion

File tree

‎website/docs/docs/commands.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,7 @@ agent-device fold open
8989
- `open <app> --launch-console <path>` captures launch-time stdout/stderr for direct iOS simulator app launches. It is not valid for URL opens or
9090
non-simulator targets.
9191
- `open --platform macos --surface app|frontmost-app|desktop|menubar` selects the macOS session surface explicitly. `app` is the default when an app argument is provided.
92+
- A surface given to `open`, as a flag or from a config file, is saved in `--save-script` scripts, so `replay` reopens the same surface. When no surface is given, the script has no `--surface`, and replay opens an app session.
9293
- `back` now defaults to app-owned back navigation. On Apple targets that means visible in-app back UI only. On Android this currently maps to the same back keyevent because Android routes in-app back through that platform event.
9394
- `back --in-app` is an explicit alias for the default app-owned behavior.
9495
- `back --system` asks for system back input explicitly. On Android this is the normal back keyevent. On iOS and tvOS it uses the platform back gesture or Siri Remote menu action. On macOS, where there is no generic system back input, `back --system` reports unavailable instead of falling back to app-owned navigation.

‎website/docs/docs/sessions.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,6 @@ Session artifact directories contain per-run evidence for concurrent agents:
3030
`events.ndjson` is privacy-shaped for automation timelines. It preserves command names, status,
3131
durations, bounded device/app inventory previews, lifecycle outcomes, artifact basenames, and
3232
structural action details such as scroll distance/direction, safe refs, and coordinates.
33-
An explicitly supplied macOS `open --surface` is preserved in recorded action flags and saved `.ad` scripts; an omitted surface stays omitted.
3433
User-entered text, clipboard contents, push/event payloads, selector values, free-form
3534
flags/messages/paths, and raw unknown command arguments are omitted or replaced with content-free
3635
placeholders. `--no-record` suppresses recorded action entries; request start/finish entries still

0 commit comments

Comments
 (0)