// troubleshooting guide · aerospace

AeroSpace Treats Tabs as Separate Windows

Status
Ongoing
platforms:
macOS
updated:
November 16, 2026
reports:
3
Method
how we research
Share

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

  1. FIX 1Add a Ghostty rule

    1. 01Add to ~/.aerospace.toml: [[on-window-detected]] if = 'test %{app-bundle-id} = com.mitchellh.ghostty' run = 'layout tiling'
    2. 02Reload the config
    3. 03If tabs still split, change it to run = 'layout floating'
    Did this fix it?
  2. FIX 2Unfloat when needed

    1. 01Press alt-shift-; then f to switch the window back to tiling
    Did this fix it?
  3. FIX 3Use tabs inside a multiplexer

    1. 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 us

Watch AeroSpace Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other AeroSpace errors