cmux-browser

# Browser Automation with cmux ## Core workflow Open or target a browser surface, verify navigation with `get url`, snapshot for fresh element refs, act on refs, wait for the state change, re-snapshot. ```bash cmux --json browser open https://example.com # returns a surface ref, e.g. 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 ``` If `get url` is empty or `about:blank`, navigate first instead of waiting on load state. Re-snapshot after navigation, modal open/close, or major DOM changes; refs go stale. ## Surface targeting `browser open` targets the workspace of the terminal running the command (`CMUX_WORKSPACE_ID`), even when another workspace is focused. Override with `--workspace` / `--window`: ```bash cmux identify --json cmux browser open https://example.com --workspace workspace:2 --window window:1 --json ``` Output defaults to short refs (`surface:N`, `pane:N`, `workspace:N`, `window:N`); UUIDs are accepted on input, and `--id-format uuids|both` requests them on output. Keep one `surface:N` per task. ## Wait ```bash cmux browser <surface> wait --selector "#ready" --timeout-ms 10000 cmux browser <surface> wait --text "Success" --timeout-ms 10000 cmux browser <surface> wait --url-contains "/dashboard" --timeou...