Spaces
Download

Browser Sessions

Browser sessions keep URL context attached to a workspace so launch, focus, and cleanup stay deterministic.

What Is a Browser Session?

A browser session is a URL you want one focus away while the workspace is running — your local app, an admin page, a PR, a runbook. Configure them on the project and every workspace inherits them.

  • • Each session has a URL and an optional name.
  • • URLs can reference a service's assigned port or its Caddy URL, for example http://localhost:$SPACES_WEB_PORT or $SPACES_WEB_URL. Chrome treats *.localhost as a secure loopback context, so these hosts resolve without extra setup.
  • • For remote Linux workspaces, service browser sessions use the same Caddy URL on the Mac while Spaces forwards the daemon-local service port over SSH.
  • • Attach as many as you need to a workspace.

Opening and Focusing

  • • Sessions stay closed when the workspace launches, so startup stays fast even with many URLs attached.
  • • Focus a session with cmd+1…cmd+0 or the command palette, and Spaces opens it as a Chrome tab in the workspace's tracked Chrome window when one is available.
  • • If you move a session tab to another Chrome window, direct focus finds that matching URL and updates tracking.
  • • Next/previous window cycling includes a browser session only after its tracked Chrome tab is open.
  • • If you close a session's Chrome tab and then focus it again, Spaces reopens it.
  • • Stopping the workspace closes the session tabs Spaces opened or adopted.

On iPhone

  • • Browser sessions show up as rows in the iOS app too, alongside each workspace's processes, coding agents, and terminals.
  • • Tap one to open the dev server right inside the app, with back, forward, reload, and screenshot controls — no need to unlock your Mac or remember a URL.
  • • Cookies and local storage stay isolated per service, the same way they do in Chrome on the Mac.
  • • This works for a remote Linux workspace too, and even while the Mac is asleep, as long as your phone is paired with the device that owns the workspace.
  • • If the service isn't running yet, tapping the row shows a clear message instead of a blank page.
  • • Browser sessions work while Spaces is in the foreground; backgrounding the app closes the connection, and reopening it restores your sessions automatically.

Example

web        $SPACES_WEB_URL
admin      $SPACES_WEB_URL/admin
prs  https://github.com/org/repo/pull