AeroSpace

• #2169 Ignore windows whose window id is zero. Fixes the mistakenly detected windows in cmux
• #2170 Improve Wispr Flow popup detection

• #2157 Fix crash
• #2153 Fix bug: floating windows sometimes could snap to top left corner when switching back and forth between workspaces. Kudos to @Williawar

• #2142 Fix bug: focus-follows-mouse didn't respect fullscreen windows
• #2143 Fix bug: do not trigger focus-follows-mouse when the mouse hovers over system menu dropdown
• #2147 Fix bug: floating windows were inserted in between of every accordion window during focusing
• #1496 Fix bug: accessing menu on non-main screen was not possible ('Displays have separate spaces' is off)

New features

• #12 Implement focus-follows-mouse
• #278 Overall, increase AeroSpace scriptability:
  • Implement shell && (and), || (or), ; (sequence) and | (pipe). See #shell section in the updated docs.
  • Implement aerospace test, aerospace test-not, aerospace eval, aerospace echo commands.
  • on-window-detected callback gets a new more composable syntax: docs (the old syntax is still supported and probably will remain supported forever: docs)
  • Related issues: #359 #842 #375 #460 #660
• 16a0b634 Migrate from TOML 1.0.0 to TOML 1.1.0. Now, you can use newlines in inline tables! Which I highly recommend in your on-window-detected callbacks instead of the dubious double square brackets syntax. AeroSpace docs were updated to use the new syntax. See TOML 1.1.0 release notes for more details.
• #1673 Introduce the warnings in reload-config command. Warnings are printed to stderr and do not block config reload. You can use the new --warnings-as-errors flag to convert warnings to errors.
  • You will now get a warning if config-version is below the maximum value.
• #163 Implement auto-reload-config config option. Kudos to @bshowell0
• #1514 Implement aerospace subscribe command - the alternative to callbacks. Kudos to @ojowwalker77
• #107 Implement aerospace run-callback command to programmatically run the specified callback.
• #1480 focus/move commands: add --fail-if-fullscreen/--fail-if-macos-native-fullscreen. Kudos to @ishangodawatta
• bb1e5429 layout command can now change the layout of an empty workspace (changes the layout of the root tiling container)
• #940 layout command: support new --root flag
• 91064acc layout command: support --workspace <workspace> flag
• #1701 Implement aerospace focus --wrap-around alias. Kudos to @i-pj

New documentation

• config-version is now properly documented: link
• AEROSPACE_WINDOW_ID and AEROSPACE_WORKSPACE environment variables are now properly documented: link
• Update the "trackpad gestures trick" in goodies to use the new more performant shell operators: link

Improvements

• #1513 The client-server socket protocol is now documented and is part of the public API. Unfortunately, this results in a breaking change for clients who interact with the socket directly.
• #2103 Treat Outlook reminders as popups. Kudos to @sivertism
• #2133 Treat Codex pet window as popup
• #776 Treat Emacs child frames as popups. Kudos to @jperras

Bug fixes

• #2084 Fix potentially infinite while loop
• #1921 Potentially fix 'Value is already destroyed' crash

Other minor bug fixes: 6021c13c, a8241641, #1064, 19b5999d 6a2a126d ecfc745c

Breaking changes

• #1513 The client-server socket protocol was changed to make it future proof and public. Unfortunately, it results in a breaking change for clients that interact with the socket directly. The clients have to be updated.
• #278 The parser of binding's right-hand side was rewritten to support the new shell operators. That results in breaking changes in some corner cases. Most of the users are not affected. But if you are doing something creative in your bindings, you might need to update them. The fix should be trivial - just quote the appropriate arguments.
• b5f9e443 layout command now return zero exit code when the layout is already applied. This only affects users who supplied a single argument to the layout command (I expect it to be rare). You can use --fail-if-noop flag to return the old behavior.
• 8ceabe9b Forbid the error prone on-window-detect callbacks with empty or non-existing if clause.

- Nikita Bobko, 30 June 2026

• 8134ad00 Make sure that floating windows never appear off screen when moved by AeroSpace (e.g. when moved between monitors). By @mobile-ar
• #1987 #1875 Fix bug: floating windows could stuck in a corner. Kudos to @fbuetler, @tweezerticle, @buacanning for finding the root cause.
• Update codesign certificate due to expiration. AeroSpace will re-request accessibility permission.

• Improve Xcode dialog heuristic. 'Open Quickly' and 'Quick Actions' are no longer treated as windows
• #1817 Don't show secure input indicator if the currently active binding mode is empty
• #1825 Improve crash logging
• #1881 Fix crash

Improvements

• 85fb9779 Performance: avoid unnecessary AX requests for focusing windows (affects apps that are slow at answering AXRaiseAction AX requests. For instance, Godot)
• #1486 Show an indication when macOS Secure Input is on. By @mobile-ar
• #1617 #1658 #1710 #1271 #221 #1667 c71c243298 Improve dialog/popup heuristics (Compatibility with: Zebar, VSCode, Screen Studio, CleanShot X, browser PIPs, Slack, and how the hell knows what else)
  • #1617 #2 Ignore browser PIP windows by default
  • New heuristic logic might break existing properly working applications. Please report issues
• #413 Improve the optimal hide corner algorithm
• #1495 Better config error reporting dialog. By @mobile-ar
• #1494 volume command now shows volume indicator. By @mobile-ar

Bug fixes

• #521 Fix bug: focus command didn't work when all windows were floating
• #1771 Fix bug: Sometimes detaching Chrome Tabs yields a floating window since Tahoe
• #1813 Ignore iTerm2 hotkey window
• #1613 #1588 Fix crashes

New features

• #999 New persistent-workspaces config option
• #1656 #1161 Support more interpolation variables in list-monitors, list-windows, list-workspaces. By @alewis001
• #711 Add i3-ordered menubar style. By @mobile-ar
• #1494 Add fullscreen mode indication in menubar. By @mobile-ar
• #20 Lift on-window-detected.run limitations
• #390 Implement on-mode-changed callback

Breaking changes

• #1683 Make users explicitly supply --stdin flag to workspace/move-node-to-workspace commands when stdin is used. By @Gai-H

- Nikita Bobko, 24 November 2025

Bug fix

• #1576 Japanese characters make the tray menu glitch

Bug fixes

• #1546 Fix NoMachine focus weirdness
• #1560 Treat choose GUI fuzzer as a popup
• #1560 Ignore focus changes from popups
• #1563 Fix 0.19.0 regression. Incorrect move-node-to-workspace exit-code

Improvements

• #1547 Float iPhone Simulator window by default

New features

• #711 Different menu bar styles. By @mobile-ar
• #183 Add --boundaries and --boundaries-action options for move command. By @gabsrp2002
• #248 Support focus dfs-next / focus dfs-prev. By @rickyz
• #8 Implement swap command. By @rickyz
• #191 Show application names in corresponding workspaces in menu bar
• #1026 Support --json and --count in list-modes command. By @MikaelCarpenter

Bug fixes

• #1216 Windows may randomly jump to the focused workspace
• #1425 move-node-to-monitor right/down should place the windows to the most left/up available position
• #164 CGPoint.findIn crash
• #1492 Floating windows could appear off-screen

Improvements

• #276 Better dialog heuristics for qutebrowser without decorations
• #1482 start-at-login = true now registers AeroSpace as a proper Login Item in System Settings

Breaking changes

• Forbid empty string in workspace names
• #1423 Drop --fail-if-noop from move-node-to-monitor <direction>
• #1482 Deprecate non-empty after-login-command

- Nikita Bobko, 11 July 2025