AeroSpace Not Working? Common Errors & Fixes
The 9 AeroSpace problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
AeroSpace Slow When Switching Workspaces
Workaround availablemacOSLag in AeroSpace almost always comes from an app whose UI thread is blocked, which stalls macOS Accessibility calls. Update AeroSpace (0.18+ reworked this), find the blocking app and turn off 'Displays have separate Spaces'.
AeroSpace Windows Stuck in Corner of Screen
Workaround availablemacOSAeroSpace hides inactive workspaces by moving their windows to the bottom-right or bottom-left screen corner. Fix your monitor arrangement so each display has a free bottom corner, or quit AeroSpace to restore windows.
AeroSpace Not Working After Update (Accessibility Permission)
Workaround availablemacOSIf AeroSpace stops tiling or won't start after a macOS or AeroSpace update, macOS has usually dropped its Accessibility permission. Remove and re-add it in Privacy & Security, and reset the permission database if it keeps turning off.
AeroSpace Keybindings Not Working
Workaround availablemacOSAeroSpace hotkeys usually fail because another app grabs the same shortcut, the config didn't load, or Accessibility permission was lost. Check for conflicts with skhd, Karabiner or Raycast, then reload the config.
AeroSpace Wrong Window Focus With Multiple Monitors
OngoingmacOSFocus jumping to the wrong window or back again on multi-monitor setups is mostly caused by the macOS 'Displays have separate Spaces' setting. The official guide recommends turning it off and logging out.
AeroSpace Tiles Popup Windows Instead of Floating
Workaround availablemacOSAeroSpace guesses which windows are dialogs, and some apps get it wrong. Toggle the window with the service-mode shortcut or add an on-window-detected rule that floats that app.
AeroSpace Treats Tabs as Separate Windows
OngoingmacOSApps that use native macOS tabs (Ghostty, Alacritty) expose each tab as a window, so AeroSpace tiles each one. Native tabs support is planned; until then, use an app rule or the app's own tabs.
AeroSpace Mission Control Windows Too Small
Workaround availablemacOSMission Control shrinks windows from other AeroSpace workspaces because they are parked in the screen corner. Turn on 'Group windows by application' to get usable thumbnails.
How to Reset a Messed Up AeroSpace Layout
Workaround availablemacOSWhen AeroSpace's tile tree gets tangled, flatten the workspace tree from service mode (alt-shift-; then r) and balance sizes. Closing extra windows or reloading the config also helps.
SANDBOX · aerospace RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on AeroSpace-style sandbox, including the spots where users get stuck. 1-2 minutes, nothing is saved.
Problem not listed? See all AeroSpace complaints or compare AeroSpace alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like AeroSpace: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code