Cmux Browser Navigating

cmux Browser Navigating

Navigate the cmux browser to a URL without taking a screenshot. Opens a split browser if none exists.

Step 1 — Discover workspace and browser surface

WS=$(cmux identify | jq -r '.focused.workspace_ref')
SURF=$(cmux rpc surface.list "{\"workspace_ref\":\"$WS\"}" | jq -r '[.surfaces[] | select(.type == "browser")] | first | .ref // empty')

• If SURF is non-empty → a browser pane exists.
• If SURF is empty → no browser pane open.

Step 2 — Open or navigate

No browser exists → open one alongside the terminal

cmux browser open-split <url>

Browser exists → navigate it and wait for load

cmux browser $SURF navigate <url>
cmux browser $SURF wait --load-state complete

Done — no screenshot.

Notes

• Prefer open-split over open to keep the terminal pane visible alongside the browser.
• Surface refs change between sessions — always discover fresh, never hardcode.
• If a screenshot is also needed after navigating, use cmux-browser-screenshooting instead.