| name | electron |
| description | Automate or test Electron desktop apps through agent-browser and Chrome DevTools Protocol, including Slack, VS Code, Discord, Figma, Notion, Spotify, and similar apps. Use when user asks to control, connect to, inspect, click, fill, screenshot, or interact with a native Electron app UI. Do not use for normal web URLs. |
| allowed-tools | Bash(agent-browser:*), Bash(npx agent-browser:*) |
Electron App Automation
Control Electron desktop apps with agent-browser through Chrome DevTools Protocol.
When to use
- User asks to automate or test an Electron app.
- App is Slack, VS Code, Discord, Figma, Notion, Spotify, or similar.
- Task needs desktop app interaction through UI.
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
- Launch app with CDP port.
- Wait for app to start.
- Connect
agent-browser.
- List tabs when multiple windows or webviews exist.
- Snapshot and interact.
- 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 ....
