molecule-ai/molecule-ai-plugin-browser-automation

CI / validate (pull_request) Failing after 2s

Details

CI / validate (push) Failing after 3s

Details

fix(browser-automation): resolve KI-001/KI-003/KI-004, add tests

- KI-001 (defaultViewport): already fixed in lib/connect.js (line 110);
  mark resolved in known-issues.md
- KI-003: add --dev-mode flag to cdp-proxy.cjs so developers can run
  the proxy locally without generating a token. Logs prominent security
  warning; production path unchanged (FATAL on missing token by default)
- KI-004 (browser.close()): already documented correctly; mark resolved
  in known-issues.md
- tests/cdp-proxy.test.js: 18 passing tests (tokenMatches, stripAuthHeader,
  loadToken logic, dev-mode auth bypass)
- tests/connect.test.js: 21 passing tests (loadProxyToken priority, file
  fallback, WS URL rewrite, fetchVersion header/status logic)
- rules/cdp-connection.md: add --dev-mode, defaultViewport: null, disconnect() rules
- README.md: fix install command, update known-issues section

2026-05-10 12:44:42 +00:00

1.9 KiB

Raw Blame History

browser-automation

Browser automation and testing. Two distinct capabilities:

Puppeteer-core / CDP — control a real Chrome browser via Chrome DevTools Protocol. For automating external websites, scraping, and cross-browser testing.
Playwright — testing our own applications with reliable selectors and auto-waiting.

Requirements

Both capabilities require the CDP proxy to be running on the host:

# Install and start the CDP proxy (once per host)
bash host-bridge/install-host-bridge.sh

The proxy requires CDP_PROXY_TOKEN (>=16 chars) or a token file at ~/.molecule-cdp-proxy-token. For local development without a token: node host-bridge/cdp-proxy.cjs --dev-mode (logs a security warning).

Puppeteer (external sites)

Connect via puppeteer.connect() using the bundled lib/connect.js helper. Always pass defaultViewport: null to avoid coordinate corruption (see known-issue KI-001).

const { connect } = require('./lib/connect.js');
const browser = await connect();
const page = await browser.newPage();
// ...
await browser.disconnect();  // NOT browser.close() — see KI-004

Playwright (internal app testing)

For testing Molecule AI's own applications. Use Playwright's built-in selectors and auto-wait for reliable tests.

Install

In org template (org.yaml)

plugins:
  - browser-automation

From URL (community install)

github://Molecule-AI/molecule-ai-plugin-browser-automation

Runtime

claude_code — primary

Skills

browser-automation — Puppeteer/CDP skill
browser-testing — Playwright skill

Known issues

See known-issues.md.

KI-002: The Chrome profile is shared across agents — use separate --user-data-dir for isolation
KI-003: For local dev without a token, use --dev-mode (logs security warning)

1.9 KiB Raw Blame History