surf-cli Codebase

Architecture

cli.cjs --socket:/tmp/surf.sock--> host.cjs --native-msg--> service-worker/index.ts --CDP/chrome-APIs--> browser

Add CLI Command

1. Add to TOOLS in native/cli.cjs:158 (args, opts, examples)
2. Add handler in src/service-worker/index.ts:50 handleMessage() switch
3. CDP op? → add method src/cdp/controller.ts:60
4. DOM interaction? → add handler src/content/accessibility-tree.ts:99

Add CDP Operation

1. Add method to CDPController class src/cdp/controller.ts:60
2. Use this.send(tabId, "Domain.method", params)
3. Handle events in handleCDPEvent() if needed