Imported from stablyai/orca (
tests/AGENTS.md). Install upstream withnpx skills add stablyai/orca --skill tests. Copyright stays with the author.
Automated App Launches
- Set
ORCA_BACKGROUND_LAUNCH=1for all tests and agent-launched apps. Useorca-app.ts/orca-restart.ts; rawelectron.launch()calls must pass the env explicitly. - Keep windows hidden and drive renderers through Playwright CDP. Never reveal windows,
steal focus, or activate the app on the user's desktop.
@headfulis for tests requiring real pixels; it does not authorize foreground activation. Never setORCA_E2E_FOREGROUND=1on the desktop. - Run native-focus and visible-window tests only on an isolated display or CI.
- Rebuild modified launch-policy code before launching; stale wrappers are unsafe.
- Only the terminal perf and
native IBus fixtures may explicitly present windows
on their isolated hosted-CI Xvfb displays. Preserve their guards and keep
ORCA_BACKGROUND_LAUNCH=1; do not generalize these exceptions to other fixtures or production launch policy. Background terminal panes stay hidden.
