ContextQMD
Back to Cmux

Command Reference (cmux Browser)

skills/cmux-browser/references/commands.md

1.38.14.0 KB
Original Source

Command Reference (cmux Browser)

This maps common agent-browser usage to cmux browser usage.

Direct Equivalents

  • agent-browser open <url> -> cmux browser open <url>
  • agent-browser goto|navigate <url> -> cmux browser <surface> goto|navigate <url>
  • agent-browser snapshot -i -> cmux browser <surface> snapshot --interactive
  • agent-browser click <ref> -> cmux browser <surface> click <ref>
  • agent-browser fill <ref> <text> -> cmux browser <surface> fill <ref> <text>
  • agent-browser type <ref> <text> -> cmux browser <surface> type <ref> <text>
  • agent-browser select <ref> <value> -> cmux browser <surface> select <ref> <value>
  • agent-browser get text <ref> -> cmux browser <surface> get text <ref-or-selector>
  • agent-browser get url -> cmux browser <surface> get url
  • agent-browser get title -> cmux browser <surface> get title

Core Command Groups

bash
cmux browser open <url>                        # opens in caller's workspace (uses CMUX_WORKSPACE_ID)
cmux browser open <url> --workspace <id|ref>   # opens in a specific workspace
cmux browser <surface> goto <url>
cmux browser <surface> back|forward|reload
cmux browser <surface> get url|title

Workspace context: browser open targets the workspace of the terminal where the command is run (via CMUX_WORKSPACE_ID), even if a different workspace is currently focused. Use --workspace to override.

Snapshot and Inspection

bash
cmux browser <surface> snapshot --interactive
cmux browser <surface> snapshot --interactive --compact --max-depth 3
cmux browser <surface> get text body
cmux browser <surface> get html body
cmux browser <surface> get value "#email"
cmux browser <surface> get attr "#email" --attr placeholder
cmux browser <surface> get count ".row"
cmux browser <surface> get box "#submit"
cmux browser <surface> get styles "#submit" --property color
cmux browser <surface> eval '<js>'

Interaction

bash
cmux browser <surface> click|dblclick|hover|focus <selector-or-ref>
cmux browser <surface> fill <selector-or-ref> [text]   # empty text clears
cmux browser <surface> type <selector-or-ref> <text>
cmux browser <surface> press|keydown|keyup <key>
cmux browser <surface> select <selector-or-ref> <value>
cmux browser <surface> check|uncheck <selector-or-ref>
cmux browser <surface> scroll [--selector <css>] [--dx <n>] [--dy <n>]

Wait

bash
cmux browser <surface> wait --selector "#ready" --timeout-ms 10000
cmux browser <surface> wait --text "Done" --timeout-ms 10000
cmux browser <surface> wait --url-contains "/dashboard" --timeout-ms 10000
cmux browser <surface> wait --load-state complete --timeout-ms 15000
cmux browser <surface> wait --function "document.readyState === 'complete'" --timeout-ms 10000

Session/State

bash
cmux browser <surface> cookies get|set|clear ...
cmux browser <surface> storage local|session get|set|clear ...
cmux browser <surface> tab list|new|switch|close ...
cmux browser <surface> state save|load <path>

Diagnostics

bash
cmux browser <surface> console list|clear
cmux browser <surface> errors list|clear
cmux browser <surface> highlight <selector>
cmux browser <surface> screenshot
cmux browser <surface> download wait --timeout-ms 10000

Agent Reliability Tips

  • Use --snapshot-after on mutating actions to return a fresh post-action snapshot.
  • Re-snapshot after navigation, modal open/close, or major DOM changes.
  • Prefer short handles in outputs by default (surface:N, pane:N, workspace:N, window:N).
  • Use --id-format both only when a UUID must be logged/exported.

Known WKWebView Gaps (not_supported)

  • browser.viewport.set
  • browser.geolocation.set
  • browser.offline.set
  • browser.trace.start|stop
  • browser.network.route|unroute|requests
  • browser.screencast.start|stop
  • browser.input_mouse|input_keyboard|input_touch

See also: