Skip to content

README.md

Latest commit

 

History

History
32 lines (21 loc) · 1.52 KB

README.md

File metadata and controls

32 lines (21 loc) · 1.52 KB

App Manual

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.

Apps

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

General Pattern

All Electron apps follow the same connection pattern:

  1. Quit the app if already running
  2. Relaunch with CDP flag: open -a "AppName" --args --remote-debugging-port=9222
  3. Connect: agent-browser connect 9222 or use Playwright/puppeteer over CDP
  4. Interact: snapshot, click, type, screenshot

Tools

  • 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)

Contributing

PRs and contributions are welcome! If you have a manual for an Electron app you've automated, feel free to open a pull request.