// troubleshooting guide · aerospace
AeroSpace Slow When Switching Workspaces
- Status
- Workaround available
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · aerospace/slow-workspace-switching5 FIXES
// quick answer
Lag 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'.
Most likely fix: Update to the latest AeroSpace
How to fix it
// try these in order, the most common fix is first
FIX 1Update to the latest AeroSpace
- 01Run brew upgrade --cask nikitabobko/tap/aerospace
- 02Restart AeroSpace
- 03The 0.18 release specifically targeted these freezes
Did this fix it?FIX 2Find the app that blocks AeroSpace
- 01When lag appears, quit open apps one at a time
- 02Test workspace switching after each quit
- 03Users found JetBrains IDEs, Spotify and Firefox the usual culprits; killing the app clears the queue
Did this fix it?FIX 3Turn off 'Displays have separate Spaces'
- 01Open System Settings > Desktop & Dock
- 02Turn off 'Displays have separate Spaces'
- 03Or run: defaults write com.apple.spaces spans-displays -bool true && killall SystemUIServer
- 04Log out and back in
Did this fix it?FIX 4Restart AeroSpace
- 01Quit AeroSpace from its menu bar icon
- 02Reopen it from Applications; users report this helps temporarily
Did this fix it?FIX 5Report it with a profile
- 01Record an Instruments.app profile while the lag happens
- 02Post it in a GitHub Discussion, as the maintainer requests for performance reports
Did this fix it?
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. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Switching workspace or focus takes hundreds of milliseconds to 10+ seconds, the desktop wallpaper shows before windows appear, and queued switches suddenly apply all at once.
Why it happens
- C-01An app's UI thread is blocked (JetBrains IDEs indexing or debugging, Spotify, Firefox, Godot)
- C-02High CPU load slows Accessibility API responses
- C-03Running an AeroSpace version older than 0.18
- C-04'Displays have separate Spaces' enabled on multi-monitor setups
// this guide also covers
- aerospace lag
- aerospace slow
- aerospace freeze switching workspace
- aerospace delay focus
Still not working?
If AeroSpace keeps failing, you're not alone. See every AeroSpace problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All slow, laggy or resource-hungry guides →
Raycast High Memory and CPU Usage (Raycast)
BetterTouchTool High CPU Usage (BetterTouchTool)
Other AeroSpace errors
- AeroSpace Windows Stuck in Corner of Screen
- AeroSpace Not Working After Update (Accessibility Permission)
- AeroSpace Keybindings Not Working
- AeroSpace Wrong Window Focus With Multiple Monitors
- AeroSpace Tiles Popup Windows Instead of Floating
- AeroSpace Treats Tabs as Separate Windows
- AeroSpace Mission Control Windows Too Small
- How to Reset a Messed Up AeroSpace Layout