Window management overview
Start with one window, then build a reusable workspace. Window and its four default submodes have independent, configurable bindings.
Try it once
Pointer over a window → Alt+W → release the entry keys → H/J/K/L → Q. On macOS use Option+W, not Command+W.
| Task | Mode | From Window |
|---|---|---|
| Move, resize, centre, cycle window states and control audio. | Window | — |
| Choose placement and ratios with direction keys. | Quick | A |
| Tile immediately; swap numbered windows and adjust regions. | Editor | E |
| Group compatible windows by application. | Tabs | T |
| Save an arrangement, then fill it with the windows you need today. | Restore | R |
Shared controls and troubleshooting
| What you see | What to try |
|---|---|
| A window has no number | Check its display, minimized state, and compatibility; candidate scope is configurable independently for each mode |
| Leaving does not restore the previous layout | Leaving keeps changes; use Z, or Shift+C in Window/Quick/Editor to restore this session's initial state |
X does something unexpected | Window closes a window, Editor removes a region, Tabs dissolves a group, and Restore toggles deletion; check the current mode hint |
| New shortcuts do not work after upgrading | An explicit [mode.bindings] replaces that mode's default table; add new bindings from the latest defaults |
Continue with Window configuration, the action reference, or macOS installation and permissions.