cmux-browser

# Browser Automation with cmux Use this skill for browser tasks inside cmux webviews. ## Core Workflow 1. Open or target a browser surface. 2. Verify navigation with `get url` before waiting or snapshotting. 3. Snapshot (`--interactive`) to get fresh element refs. 4. Act with refs (`click`, `fill`, `type`, `select`, `press`). 5. Wait for state changes. 6. Re-snapshot after DOM/navigation changes. ```bash cmux --json browser open https://example.com # use returned surface ref, for example: surface:7 cmux browser surface:7 get url cmux browser surface:7 wait --load-state complete --timeout-ms 15000 cmux browser surface:7 snapshot --interactive cmux browser surface:7 fill e1 "hello" cmux --json browser surface:7 click e2 --snapshot-after cmux browser surface:7 snapshot --interactive ``` ## Surface Targeting ```bash # identify current context cmux identify --json # open routed to a specific topology target cmux browser open https://example.com --workspace workspace:2 --window window:1 --json ``` Notes: - CLI output defaults to short refs (`surface:N`, `pane:N`, `workspace:N`, `window:N`). - UUIDs are still accepted on input; only request UUID output when needed (`--id-format uuids|both`). - Keep using one `surface:N` per task unless you intentionally switch. ## Wait Support cmux supports wait patterns similar to agent-browser: ```bash cmux browser <surface> wait --selector "#ready" --timeout-ms 10000 cmux browser <surface> wait --text "Success" --timeout-ms 10000 cmux...