Skip to content

AeroSpace

A tiling window manager for macOS. Apps are organized into named workspaces and controlled entirely by keyboard.

KeyWorkspaceApps
WWorkCursor, VSCode
SShellGhostty, Warp, WezTerm
BBrowserChrome, Safari, Firefox, Dia
CCommunicationSlack (sub-monitor recommended)
MMusicSpotify, Apple Music
NNotionDocumentation
DDiscordDiscord
GGatherReserved (floating mode)
1-5GeneralFree use
KeyAction
Alt+h/j/k/lFocus window (crosses monitors)
Alt+Shift+h/j/k/lMove window within workspace
KeyAction
Alt+Ctrl+h/j/k/lMove window to another monitor
Alt+Ctrl+nMove to next monitor (wraps)
Alt+Ctrl+pMove to previous monitor (wraps)
KeyAction
Alt+rTiles layout (side by side)
Alt+Shift+rAccordion layout (stacked)
Alt+tToggle floating/tiling
Alt+fFullscreen
KeyAction
Alt+-Shrink by 50
Alt+=Grow by 50
KeyAction
Alt+1-5Switch to workspace 1-5
Alt+w/b/c/g/m/n/s/dSwitch to named workspace
Alt+TabPrevious workspace
Alt+Shift+TabMove workspace to next monitor
KeyAction
Alt+Shift+1-5Move to workspace and follow
Alt+Shift+w/b/c/g/m/n/s/dMove to named workspace and follow

Enter with Alt+Shift+;:

KeyAction
EscReload config, back to main mode
rReset workspace tree layout
fToggle floating/tiling
BackspaceClose all windows except current
  • Default layout is accordion (single window gets full space)
  • Apps auto-assign to their dedicated workspace
  • Padding: top 52px (sketchybar 40px + 12px), horizontal 12px, vertical 8px
  • Gather uses floating mode so it can move freely between monitors
  • Each monitor has independent workspaces