SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillselectron

electron

Testing & quality

View repository

Updated 10-15 21:43

About this skill

Electron App Automation

Control Electron desktop apps with agent-browser through Chrome DevTools Protocol.

Goal

  • Launch app with remote debugging.
  • Connect agent-browser.
  • Use snapshots to find refs.
  • Interact with the app like a user.

Rules

  • App must be launched with --remote-debugging-port.
  • If app is already running, quit and relaunch with flag.
  • Prefer unique ports for multiple apps.
  • Use named sessions when controlling multiple apps.
  • Use snapshot -i before clicking or filling.
  • Re-snapshot after navigation or state changes.

Flow

  1. Launch app with CDP port.
  2. Wait for app to start.
  3. Connect agent-browser.
  4. List tabs when multiple windows or webviews exist.
  5. Snapshot and interact.
  6. Capture screenshots or data as needed.

Launch examples

open -a "Slack" --args --remote-debugging-port=9222
open -a "Visual Studio Code" --args --remote-debugging-port=9223
open -a "Discord" --args --remote-debugging-port=9224
open -a "Figma" --args --remote-debugging-port=9225
open -a "Notion" --args --remote-debugging-port=9226
open -a "Spotify" --args --remote-debugging-port=9227

Linux:

slack --remote-debugging-port=9222
code --remote-debugging-port=9223
discord --remote-debugging-port=9224

Windows:

"C:\Users\%USERNAME%\AppData\Local\slack\slack.exe" --remote-debugging-port=9222
"C:\Users\%USERNAME%\AppData\Local\Programs\Microsoft VS Code\Code.exe" --remote-debugging-port=9223

Connect

agent-browser connect 9222
agent-browser snapshot -i
agent-browser click @e5
agent-browser screenshot app.png

Use per-command CDP when needed:

agent-browser --cdp 9222 snapshot -i

Tabs and webviews

agent-browser tab
agent-browser tab 2
agent-browser tab --url "*settings*"

Webviews appear as separate targets. Switch to the right target before interacting.

Multiple apps

agent-browser --session slack connect 9222
agent-browser --session vscode connect 9223
agent-browser --session slack snapshot -i
agent-browser --session vscode snapshot -i

Troubleshooting

  • Connection refused: relaunch app with CDP flag.
  • Wrong window: run agent-browser tab.
  • Elements missing: switch tab or webview.
  • App slow to appear: wait a few seconds, then snapshot again.
  • Dark mode lost: use agent-browser --color-scheme dark ....