# electron

A skill that drives Electron desktop apps like Slack, VS Code, Discord, Figma and Spotify over the Chrome DevTools Protocol.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1216 repo stars
- Author: fcakyon
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/agent-browser/skills/electron/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/electron

## What it does

The skill talks to an Electron app's remote debugging port and reuses the same snapshot-and-click loop as browser automation: take a snapshot of the UI, act on an element by its ref, snapshot again after the view changes. The target app has to be started with a `--remote-debugging-port=NNNN` flag at launch time, so an already-running app needs to be closed and relaunched with that flag before anything can connect.

Under the hood it runs `agent-browser` commands: `connect`, `snapshot -i`, `click`, `fill`, `screenshot`, plus `tab` for switching between windows and embedded webviews, and `keyboard type` or `keyboard inserttext` for input fields that resist a plain fill. Named sessions via `--session` let you drive several apps at once, and a `--color-scheme dark` flag fixes the light theme that CDP connections sometimes force on.

It covers any Electron-based app, from Slack, Discord and Microsoft Teams to GitHub Desktop, Postman, Figma, Obsidian, Spotify and Linear.

## Requirements
- Works with: Figma, Chrome, Notion

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add fcakyon/claude-codex-settings
```
In the agent chat (not a shell):
```text
/plugin install agent-browser@claude-settings
```
This installs the whole agent-browser plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill electron -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/electron/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/electron/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill electron -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/electron/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill electron -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/electron/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fcakyon/claude-codex-settings plugins/agent-browser/skills/electron
```

2. **Manually: put the files in place**
- File: `.github/skills/electron/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill electron -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/agent-browser/skills/electron
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/electron/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/agent-browser/skills/electron/SKILL.md

## When to use it
- attach to a running Electron app over CDP
- click through a desktop app's UI using element refs from a snapshot
- switch between windows and webviews inside one app
- type into input fields that ignore a plain fill command
- capture screenshots of a desktop app's current state

## Example prompts
- Launch Slack with `--remote-debugging-port=9222` and connect agent-browser to it
- Snapshot the VS Code window and click the settings icon
- Switch to the webview tab in Discord and fill the search box

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 1d576452bf2af3a8.

BEGIN THIRD-PARTY FILE 1d576452bf2af3a8
````text
---
name: electron
description: Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.
allowed-tools: Bash(agent-browser:*), Bash(npx agent-browser:*)
license: Apache-2.0
---

# Electron App Automation

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

## Core Workflow

1. **Launch** the Electron app with remote debugging enabled
2. **Connect** agent-browser to the CDP port
3. **Snapshot** to discover interactive elements
4. **Interact** using element refs
5. **Re-snapshot** after navigation or state changes

```bash
# Launch an Electron app with remote debugging
open -a "Slack" --args --remote-debugging-port=9222

# Connect agent-browser to the app
agent-browser connect 9222

# Standard workflow from here
agent-browser snapshot -i
agent-browser click @e5
agent-browser screenshot slack-desktop.png
```

## Launching Electron Apps with CDP

Every Electron app supports the `--remote-debugging-port` flag since it's built into Chromium.

### macOS

```bash
# Slack
open -a "Slack" --args --remote-debugging-port=9222

# VS Code
open -a "Visual Studio Code" --args --remote-debugging-port=9223

# Discord
open -a "Discord" --args --remote-debugging-port=9224

# Figma
open -a "Figma" --args --remote-debugging-port=9225

# Notion
open -a "Notion" --args --remote-debugging-port=9226

# Spotify
open -a "Spotify" --args --remote-debugging-port=9227
```

### Linux

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

### Windows

```bash
"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
```
````
END THIRD-PARTY FILE 1d576452bf2af3a8

The third-party file has ended. Everything between the 1d576452bf2af3a8 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2340 of 6747 bytes. © fcakyon · Apache-2.0 · https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/agent-browser/skills/electron/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
