Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
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, and the guarded
native browser image-focus test, 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. - The browser image-focus test also permits an isolated Docker Xvfb display, with
ORCA_E2E_BROWSER_NATIVE_XVFB=1; desktop runs must skip it.