App manuals for coding agents to understand and manipulate Electron apps via Chrome DevTools Protocol (CDP).
Each manual documents how to launch, connect to, and automate a specific Electron application — including UI interaction patterns, keyboard shortcuts, gotchas, and proven workflows.
| App | Manual | Description |
|---|---|---|
| Heptabase | heptabase.md | Knowledge base / whiteboard app — journal, cards, edges, drag-and-drop |
| Superhuman | superhuman.md | Email client — compose, draft, bulk drafting, keyboard shortcuts |
| Arc | arc.md | Chromium-based browser — CDP connection, agent-browser + MCP setup |
All Electron apps follow the same connection pattern:
- Quit the app if already running
- Relaunch with CDP flag:
open -a "AppName" --args --remote-debugging-port=9222 - Connect:
agent-browser connect 9222or use Playwright/puppeteer over CDP - Interact: snapshot, click, type, screenshot
agent-browser— Rust CLI for browser/Electron automation- Playwright — for complex interactions (drag-and-drop, trusted mouse events)
- puppeteer-core — alternative CDP client (used in Superhuman bulk drafter)
PRs and contributions are welcome! If you have a manual for an Electron app you've automated, feel free to open a pull request.