// troubleshooting guide · aerospace
AeroSpace Treats Tabs as Separate Windows
- Status
- Ongoing
- platforms:
- macOS
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · aerospace/tabs-as-separate-windows3 FIXES
// quick answer
Apps 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.
Most likely fix: Add a Ghostty rule
How to fix it
// try these in order, the most common fix is first
FIX 1Add a Ghostty rule
- 01Add to ~/.aerospace.toml: [[on-window-detected]] if = 'test %{app-bundle-id} = com.mitchellh.ghostty' run = 'layout tiling'
- 02Reload the config
- 03If tabs still split, change it to run = 'layout floating'
Did this fix it?FIX 2Unfloat when needed
- 01Press alt-shift-; then f to switch the window back to tiling
Did this fix it?FIX 3Use tabs inside a multiplexer
- 01Use tmux or the app's own non-native tabs instead of macOS tabs
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
Opening a new tab in Ghostty or another app creates a new tile, or tabs flicker and fullscreen behaves oddly.
Why it happens
- C-01macOS Accessibility API reports each native tab as a separate window
- C-02AeroSpace has no native tabs support yet (#68, waiting on the core refactor)
// this guide also covers
- aerospace ghostty tabs
- aerospace native tabs
- aerospace alacritty tabs separate windows
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 usOther AeroSpace errors
- AeroSpace Slow When Switching Workspaces
- 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 Mission Control Windows Too Small
- How to Reset a Messed Up AeroSpace Layout