v0.20.0-Beta

[nikitabobko]

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

---

This discussion was created from the release v0.20.0-Beta.

[iandol]

Thanks to Nikita and the contributors, very nice update! Some questions:

1. How can we use on-mode-changed to identify which mode we entering? Currently I change my sketchybar color depending on the mode manually for each entry in the mode. I assume there is an variable, but missed what its name is in https://nikitabobko.github.io/AeroSpace/guide#callbacks or the default.config
2. What is the benefit of a persistent workspace?

Secure input change is awesome BTW, this really helps, I was using a slow script polling solution before so this is much nicer @mobile-ar !

[nikitabobko]

What is the benefit of a persistent workspace?

AeroSpace has always had a notion of persistent workspaces internally. Previously, AeroSpace tried to infer which workspaces are persistent itself by scanning workspace X commands in user's config, which was proven to be problematic, and didn't cover all cases (e.g. some users preferred to use 3rd party hotkey daemons like skhd). Now this config option is surfaced to users directly.

For me personally, persistent workspaces are useful to keep workspace-to-monitor manual assignment even when the workspaces in question are invisible and empty.

Other than that, persistent workspaces might be useful, because they will stay in the menu bar and you can access them with the mouse, they will also stay in list-workspaces output, so you might control which workspaces you show in your 3rd party bar more precisely.

[nikitabobko]

How can we use on-mode-changed to identify which mode we entering?

You can use aerospace list-modes --current inside exec-and-forget

[TaylorJonesTRT]

Bless you, this finally fixed my PiP issues with Zen Browser and Aerospace not making it float on window detection!

[exic]

Thank you so much for your work. It's so much smoother with the update, being my daily driver this makes my day so much better!

[ojpro]

Thanks for this update, it fixed many issues

[bodiug]

Did this release change how Slack Huddle's behave? When I am in a huddle the window is shown on all my workspaces and is shown on top of existing windows.

[alewis001]

A huge thanks to you @nikitabobko for the new release.

[zzJinux]

Are browser pip windows supposed to be sticky since this release? I just installed this release and restarted Aerospace, and pips still seem to be bound to workspaces.

[ojpro]

I had a workaround before this update (#2 comment), but this update seems to work without it

[zzJinux]

Weird... What is it not working on my Mac? :( @ojpro Are you using macOS 15?

[ojpro]

Yes, macOS 15.7, you may Quit and Restart Aerospace, also if you want u can use the script I mentioned before as it solve this issue as well

[zzJinux]

My fault. I should've interpreted Nikita's comment verbatim. Microsoft Edge is expected to be unsupported.

[veeam-dkuznetsov]

Thanks for the update!

#1486 Show an indication when macOS Secure Input is on. By @mobile-ar

Is there any way to disable the secure input indicator?
I don’t use the Aerospace built‑in hotkeys, so I don’t grant it keyboard access, which causes the indicator to be displayed constantly.

[nikitabobko]

Fair. In the next update, the indicator won't be shown if the currently active binding mode is empty: 5caa63a

[iandol]

The secure input marker contributed by @mobile-ar is great, however one thing it doesn't do it tell you which PID / app is causing it. It would be nice to know as you can then act on the app, my previous solution used the following script which at least got me the PID:

secure_input_enabled=$(ioreg -l -w 0 | grep SecureInput)
pid=$(echo "$secure_input_enabled" | sed -n 's/.*PID"=\([0-9]\{1,\}\).*/\1/p' | head -n 1)

[oschrenk]

Will hopefully remember this thread next time.

I googled for 30 minutes or so trying to figure out what this feature is and how to control it. I also confused it with "Input Monitoring"
Was also opening different terminals and checked their Secure Input setting. Nothing helped.

In the end I found a Stackoverflow thread that says to Lock the Screen, and re-login. that somehow works. Not sure if I feel more secure that way, but I guess macOS thinks that way.

[UnchartedSystems]

Unfortunately Aerospace still struggles with Godot. Launching Godot (and especially loading a project) induces a multi-second delay across many Aerospace actions, such as resizing windows after any window instantiation or deletion.

I've got an M4 Macbook Air with 16GB RAM running MacOS 15.6.1 (24G90)

[SamWraith]

Really excited to install this update but, I am unable to upgrade aerospace from homebrew, is the updated cask not uploaded to homebrew?

[ojpro]

You may need to do brew update first