cmux-browser

Source excerpt starting at line 1.

1# Session Management2 3cmux gives each browser surface its own context. Every surface is an independent session with its own cookies, localStorage/sessionStorage, tab list and active tab, and navigation history. Related: [authentication.md](authentication.md), [../SKILL.md](../SKILL.md).4 5Keep the handle returned by creation or6[surface discovery](surface-discovery.md); never use a guessed default.7 8## Parallel sessions9 10Each `cmux browser open` returns a new surface ref; drive them independently.11 12```bash13FIRST_JSON="$(cmux --json browser open https://site-a.example --focus false)"14FIRST_SURFACE="$(printf '%s' "$FIRST_JSON" | jq -r '.surface_ref // .surface_id // empty')"15SECOND_JSON="$(cmux --json browser open https://site-b.example --focus false)"16SECOND_SURFACE="$(printf '%s' "$SECOND_JSON" | jq -r '.surface_ref // .surface_id // empty')"17[ -n "$FIRST_SURFACE" ] && [ -n "$SECOND_SURFACE" ] || exit 118 19ARTIFACT_DIR="${XDG_RUNTIME_DIR:-${TMPDIR:-/tmp}}/cmux-browser-output"20umask 07721mkdir -p "$ARTIFACT_DIR"22chmod 700 "$ARTIFACT_DIR"23cmux browser --surface "$FIRST_SURFACE" get text body > "$ARTIFACT_DIR/a.txt"24cmux browser --surface "$SECOND_SURFACE" get text body > "$ARTIFACT_DIR/b.txt"25chmod 600 "$ARTIFACT_DIR/a.txt" "$ARTIFACT_DIR/b.txt"26```27 28## Reusing auth across surfaces29 30```bash31STATE_DIR="${XDG_RUNTIME_DIR:-${TMPDIR:-/tmp}}/cmux-browser-state"32umask 07733mkdir -p "$STATE_DIR"34chmod 700 "$STATE_DIR"35STATE_FILE="$STATE_DIR/auth.json"36SOURCE_SURFACE="surface:7"       # from discovery37DESTINATION_JSON="$(cmux --json browser open https://app.example.com --focus false)"38DESTINATION_SURFACE="$(printf '%s' "$DESTINATION_JSON" | jq -r '.surface_ref // .surface_id // empty')"39[ -n "$DESTINATION_SURFACE" ] || exit 140cmux browser --surface "$SOURCE_SURFACE" state save "$STATE_FILE"41chmod 600 "$STATE_FILE"42cmux browser --surface "$DESTINATION_SURFACE" state load "$STATE_FILE"43cmux browser --surface "$DESTINATION_SURFACE" goto https://app.example.com/dashboard44```45 46## Cleanup47 48```bash49STATE_DIR="${XDG_RUNTIME_DIR:-${TMPDIR:-/tmp}}/cmux-browser-state"50STATE_FILE="${STATE_FILE:-$STATE_DIR/auth.json}"51cmux close-surface --surface surface:752rm -f "$STATE_FILE"53```54 55## Best practices56 57Log only the surface refs needed to keep actions attributable (not raw URLs or58auth payloads), keep one task per surface to avoid ref churn, save state after59successful auth milestones, and re-snapshot after switching tabs or pages60inside a surface.61