Window Management

Spaces captures the windows a workspace opens and jumps you back to any one of them with a keystroke. It doesn't move or resize them.

What Spaces Tracks

Spaces remembers the client windows that belong to a workspace:

  • • Spaces terminal panes for processes, coding agents, and ad hoc terminals.
  • • Chrome tabs for browser sessions after you focus those sessions.

Place those windows wherever you want. Spaces never moves, resizes, or tiles them without explicit user action — and never touches windows it didn't open.

Command Palette First

  • • Press cmd+alt+- to open the command palette.
  • • With an empty query, Spaces shows Alerts first and then your most recently used windows so you can jump to any with a keyboard shortcut.
  • • Start typing to fuzzy search across workspace title, target name, and detail text.
  • • Press return to focus a live window or open the selected target directly if it isn't live yet.

Direct Window Focus from the UI

  • cmd+1 through cmd+0 open or focus targets 1 through 10 of the selected workspace.
  • • Click a row in the workspace's window list to focus that window.
  • • Use cmd+alt+] and cmd+alt+[ to cycle through already-open Chrome browser-session tabs and Spaces terminal panes in the current workspace.
  • • A brief color pulse (optional) flashes on terminal windows so you can see where focus landed.

Open in Your Editor

  • • Press cmd+alt+e to open the selected workspace in your preferred editor. Choose it in Settings under General — Spaces lists whichever of VS Code, Devin Desktop, and Zed you have installed.
  • • Re-opening focuses the editor's existing window for that folder instead of opening a duplicate.
  • • For a workspace on a paired remote device, the editor opens the remote folder over SSH as a local window. Devin Desktop and Zed handle this out of the box; for VS Code, Spaces offers to install the Remote-SSH extension if it's missing.

Recovery

  • • If you close a tracked browser tab, focusing it reopens the URL in a tracked workspace Chrome window.
  • • If you close a tracked terminal window, Spaces reopens it and reattaches to the still-running process.
  • • If the underlying process is gone, Spaces prompts you before restarting it (Cmd+R to recover, Esc to cancel).

Example Window Set

Workspace: feat/checkout
1. frontend — http://localhost:21004
2. admin panel — http://localhost:21005/admin
3. GitHub — https://github.com/org/repo
4. web server — npm run dev
5. worker — npm run worker