Skip to content

docs(testing): e2e checklist for what landed since v2.0.0, and an unattended macOS run #1128

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
EtienneLescot merged 2 commits into from
Oct 12, 2026
Merged

docs(testing): e2e checklist for what landed since v2.0.0, and an unattended macOS run #1128

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
601b997
docs(testing): cover what landed since v2.0.0 in the e2e checklist, a…
EtienneLescot Oct 12, 2026
13f8079
docs(testing): run Apple's picker checks before the Screen Recording …
EtienneLescot Oct 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,7 +114,8 @@ This section is the *mechanics*. **What to actually run is [`technical-documenta

- `request_access` resolves names against installed apps. A **dev build runs as `electron.exe`** (or `Electron.app`), *not* the installed `Openscreen` — grant **`electron.exe`** or the dev window stays masked in screenshots. An installed build, CI artifact included, is the other way round: grant **`Openscreen`**. Non-allowlisted windows are masked (solid rectangles); the screenshot note lists their process names to add.
- **Start the app before asking for it.** `electron.exe` is not an installed app, so the resolver only finds it once the process exists *and* owns a window; ask any earlier and the call fails with `doesn't match any installed or running application` — and one unresolvable name short-circuits the whole request, including the names that would have resolved. Granting `Openscreen` instead is not a workaround: it resolves to `…\programs\openscreen\openscreen.exe`, so the dev window stays masked while the grant reports success.
- **Some windows a pass needs are not OpenScreen's.** Apple's source picker (macOS 15.2+) and the macOS permission prompts are drawn by system processes, the Linux portal picker by the desktop's portal. Which process owns each is not recorded yet: grant the one the screenshot note names, and write it into the checklist's grant step for the next run.
- **Some windows a pass needs are not OpenScreen's.** The macOS permission prompts are drawn by system processes, the Linux portal picker by the desktop's portal. Which process owns each is not recorded yet: grant the one the screenshot note names, and write it into the checklist's grant step for the next run.
- **Apple's source picker (macOS 15.2+) belongs to Control Centre, which computer-use cannot be granted.** Launch with `OPENSCREEN_MAC_SOURCE_PICKER=legacy` so the source button opens the app's own selector instead, which the agent drives; the cost is a one-time Screen Recording grant. Only the checks on Apple's picker itself are left to a human. Recipe: [Running the pass unattended on macOS](technical-documentation/testing/manual-e2e-checklist.md#running-the-pass-unattended-on-macos).

**The HUD widget** (recording controller)

Expand Down
Loading
Loading