Muxy

Documentation

Window Management

Muxy maps workspace windows to captured IDs and browser URL targets so context switching stays deterministic across terminals and Chrome tabs.

Window Sources

  • • Terminal windows from workspace processes.
  • • Browser tabs/windows discovered from browser session URL prefixes.
  • • Terminal windows opened from workspace action buttons.
  • • Reconciled window records persisted with workspace state.

Switching Order

Workspace navigation is ordered for repeatability during rapid context switches.

  • • Browser session tabs first.
  • • Terminal windows second.
  • • Other captured windows third.
  • • Subsequent next/previous navigation continues from remembered cycle position.

Browser Tab Matching

  • • Browser session matching is URL-prefix based.
  • • Browser cleanup closes matching tabs only, never full Chrome windows.
  • • If tabs already match session URLs, Muxy reuses them instead of opening duplicates.

Keyboard Window Focus

  • • `cmd+1` through `cmd+9` focus numbered windows for the selected workspace.
  • • Window shortcut hints are shown inline in the workspace detail pane.
  • • `cmd+shift+]` and `cmd+shift+[` cycle workspace windows forward/backward.

Example Window Set

Workspace: feat/checkout
1. Google Chrome — http://localhost:21004/checkout
2. Google Chrome — https://github.com/org/repo/pull/912
3. iTerm2 — web process
4. iTerm2 — worker process

Screenshot Placeholder

Workspace Window List

Window rows with inline `cmd+<n>` hints, app names, and titles/URLs.

Screenshot Placeholder

Browser Session Focus

Tracked browser entries focusing the matching tab by URL prefix.