Release / 24 Nov 2025

AeroSpace v0.20.0-Beta

Keep chosen workspaces available even when they are empty.

Before you upgrade to v0.20.0-Beta

2 to fix

Add `--stdin` to `workspace next/prev` or `move-node-to-workspace next/prev` when piping workspace names; use `--no-stdin` to ignore input.

Action requiredSwitch between virtual workspaces without animations.Affects: Scripts piping workspace lists to workspace-cycling commands.Inferred

Read the evidence

nikitabobko/AeroSpace/blob/v0.20.0-Beta/docs/aerospace-workspace.adoc

Volume commands now show an indicator; `--no-gui` suppresses it.

Behavior changedAdjust or mute system volume from a keyboard binding.Inferred

Read the evidence

nikitabobko/AeroSpace/blob/v0.20.0-Beta/docs/aerospace-volume.adoc

The supplied service-mode configuration no longer binds arrow keys to volume commands.

Behavior changedConfigure keyboard shortcuts and binding modes in a text file.Inferred

Read the evidence

nikitabobko/AeroSpace/blob/v0.20.0-Beta/docs/config-examples/default-config.toml

For source builds, use macOS 14+ for debug builds or macOS 15+ with Xcode 26+ for release builds; the repository selects Swift 6.2.1.

Action requiredAffects: Users building AeroSpace from source; packaged binaries still run on macOS 13+.Inferred

Read the evidence

What changed in v0.20.0-Beta

Set `config-version = 2` and `persistent-workspaces` to choose which empty workspaces survive; window rules can run additional commands and binding-mode changes can trigger callbacks.

v0.20.0-Beta; Beta for macOS 13+, available as a GitHub release archive; Accessibility permission required.

New things you can do

Keep explicitly named workspaces alive when empty and invisible.

Added

Read the evidence

nikitabobko/AeroSpace/blob/v0.20.0-Beta/docs/config-examples/default-config.toml

Fixed and improved

`on-window-detected` is no longer restricted to layout and workspace-move commands; `on-mode-changed` can run commands on binding-mode changes.

Limit liftedRun rules when windows appear and commands when focus changes.Inferred

Read the evidence

Query parent and root layouts and the main-monitor flag through `--format` variables.

ImprovedQuery windows, workspaces, monitors and applications from scripts.

Read the evidence

nikitabobko/AeroSpace/blob/v0.20.0-Beta/docs/aerospace-list-windows.adoc

A visible notice explains when macOS Secure Input prevents shortcuts from working.

ImprovedConfigure keyboard shortcuts and binding modes in a text file.Inferred

Read the evidence

nikitabobko/AeroSpace/blob/v0.20.0-Beta/Sources/AppBundle/ui/SecureInputView.swift

Directional focus works when all windows are floating; browser picture-in-picture and iTerm2 hotkey windows receive revised popup detection.

Now worksArrange and resize windows in nested tiles or accordion layouts.Inferred

Read the evidence

nikitabobko/AeroSpace/compare/v0.19.2-Beta...v0.20.0-Beta

Seeded by @iluxav with Codex, from the release's public sources. Each change links to its evidence.