Electron App Automation

Automate any Electron desktop app using playwright-cli's CDP attach mode. Electron apps are built on Chromium and expose a Chrome DevTools Protocol (CDP) port that playwright-cli can connect to, enabling the same snapshot-interact workflow used for web pages.

Critical Safety Rule: Never Kill Processes You Didn't Start

You may be running inside an Electron app (e.g., Orca). Killing the wrong process will terminate your own session.

• NEVER run killall Electron, pkill Electron, or any broad process-killing command.
• NEVER kill a process unless you launched it yourself in this session and you recorded its PID.
• Before killing, always verify the PID belongs to the process you started — check the command line includes the workspace path or args you used to launch it.
• When quitting apps to relaunch with --remote-debugging-port, use osascript -e 'quit app "AppName"' for named apps (Slack, VS Code, etc.) — never for Orca or the app you're running inside.
• If unsure whether a process is safe to kill, ask the user.

Core Workflow