osfeed.dev

Sign in Use with your agentConnect an agent

AeroSpace

A tiling window manager for macOS

by

Get it on GitHub

Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated 1 Oct 2026, so it may lag behind newer releases.

Are you @nikitabobko?Claim it, and your coding agent keeps it current with each release

Updated 1 Oct 2026 14 things you can do 16 changes to know before upgrading

Follow GitHub

Arrange macOS windows into keyboard-controlled layouts and switch workspaces across monitors.

What you can do with AeroSpace

Arrange and resize windows in nested tiles or accordion layouts.

ExperimentalPresent at v0.19.0-Beta

Good to know

Public Beta; the README lists unresolved native-tab support and windows jumping between workspaces.

Wrong?

Switch between virtual workspaces without animations.

ExperimentalPresent at v0.19.0-Beta

Good to know

Uses AeroSpace's own workspaces rather than native macOS Spaces.

Wrong?

Move windows and workspaces between monitors.

1 other tool for: Move windows between monitors

ExperimentalPresent at v0.19.0-Beta

Good to know

Each monitor displays a different workspace; monitor arrangement affects workspace emulation.

Wrong?

Keep selected windows floating above the tiled layout.

ExperimentalPresent at v0.19.0-Beta

Good to know

App-specific dialog detection uses heuristics.

Wrong?

Configure keyboard shortcuts and binding modes in a text file.

ExperimentalPresent at v0.19.0-Beta

Good to know

Configuration uses TOML; key bindings must be explicitly defined.

Wrong?

Run rules when windows appear and commands when focus changes.

1 other tool for: Automate window placement

ExperimentalPresent at v0.19.0-Beta

Good to know

Window titles may appear after the detection callback; focus callbacks should not rely on execution order.

Wrong?

Query windows, workspaces, monitors and applications from scripts.

1 other tool for: Query window state

ExperimentalPresent at v0.19.0-Beta

Good to know

Requires the running AeroSpace application and CLI.

Wrong?

Adjust or mute system volume from a keyboard binding.

ExperimentalPresent at v0.19.0-Beta

Good to know

Requires configuring a binding or invoking the volume command.

Wrong?

Show all 14

Swap windows in a direction or in depth-first order.

ExperimentalSince v0.19.2-Beta

Good to know

Supports optional focus swapping and wraparound within the workspace.

Wrong?

Keep explicitly named workspaces alive when empty and invisible.

ExperimentalSince v0.20.0-Beta

Good to know

Requires config-version = 2; the fallback list is empty and duplicate names are rejected.

Wrong?

Combine window-management commands with conditions, sequences and pipes.

ExperimentalSince v0.21.2-Beta

Good to know

Uses a subset of shell syntax; && binds more tightly than || and pipes use pipefail semantics.

Wrong?

Focus windows by moving the pointer over them.

ExperimentalSince v0.21.2-Beta

Good to know

Opt in with focus-follows-mouse.enabled = true; non-native menu-like windows may not be ignored.

Wrong?

Choose a floating or tiled layout for the next window AeroSpace detects.

ExperimentalSince commit 74a1bf1

Good to know

Branch-only; accepts exactly one of tiling or floating and no other flags. A new request replaces the previous one and takes precedence over window-detected callbacks.

Wrong?

Who AeroSpace is for

Advanced macOS users and developers who prefer keyboard controls and text configuration.

What it needs

macOS 13+ and Accessibility permission. Branch source builds require swiftly and Swift 6.4; debug builds need macOS 14+, release builds macOS 15+ and Xcode 26.6+.

How mature it is

Public Beta; the README says breaking changes are possible before 1.0 and lists unresolved window-placement and native-tab limitations.

Tried AeroSpace?

With your GitHub sign-in, one answer per person. Answer again to change it.

New in commit 74a1bf1

Choose whether the next detected window opens floating or tiled.

1 Oct 2026

Before you upgrade AeroSpace

Newest first

commit 74a1bf11 Oct 2026

Install `swiftly` and the Swift 6.4.0 toolchain selected by `.swift-version`; release builds now require Xcode 26.6+ on macOS 15+. Debug builds require macOS 14+.

Action requiredInferredAffects: Users building the default branch from source.

Read the evidence

Wrong?

v0.21.2-Beta7 Jul 2026

For an unconditional `on-window-detected` rule that stops processing, add `if = 'true'`; omitting `if` is accepted only with `check-further-callbacks = true`.

Action requiredInferredAffects: Window-detected rules with no condition and no check-further-callbacks setting.

Read the evidence

nikitabobko/AeroSpace/blob/v0.21.0-Beta/Sources/AppBundle/config/parseOnWindowDetected.sw…

Wrong?

v0.21.2-Beta7 Jul 2026

Legacy `on-window-detected` conditions such as `if.app-id` are soft-deprecated but still supported; command predicates such as `if = 'test ...'` are documented replacements.

Behavior changed

Read the evidence

nikitabobko/AeroSpace/blob/v0.21.0-Beta/docs/guide.adoc

Wrong?

Show 13 older

v0.21.2-Beta7 Jul 2026

Quote literal reserved characters in binding and callback command arguments, separate quoted words with spaces, and escape command-line continuations with a backslash.

Action requiredInferredAffects: Bindings and callbacks whose arguments relied on the old command parser.

Read the evidence

nikitabobko/AeroSpace/blob/v0.21.0-Beta/Sources/AppBundle/shell/shellLexer.swift

Wrong?

v0.21.2-Beta7 Jul 2026

Add `--fail-if-noop` when scripts need `layout` to return a failure for an unchanged layout; by default an unchanged layout now succeeds.

Action requiredInferredAffects: Scripts branching on layout's previous no-op failure status.

Read the evidence

nikitabobko/AeroSpace/blob/v0.21.0-Beta/docs/aerospace-layout.adoc

Wrong?

v0.21.2-Beta7 Jul 2026

Configuration reloads can apply valid settings despite minor errors; warnings go to stderr, while `--warnings-as-errors` reports them as errors.

Behavior changedInferred

Read the evidence

Wrong?

v0.21.2-Beta7 Jul 2026

Update custom socket clients to exchange a four-byte protocol version of 1 before sending length-prefixed JSON requests.

Action requiredInferredAffects: Custom clients using AeroSpace's Unix socket directly.

Read the evidence

nikitabobko/AeroSpace/blob/v0.21.0-Beta/docs/guide.adoc

Wrong?

v0.21.2-Beta7 Jul 2026

Update scripts that require an exact generic-error exit code: generic errors now use 2; test conditions distinguish false from errors.

Action requiredInferredAffects: Scripts interpreting specific numeric exit codes.

Read the evidence

nikitabobko/AeroSpace/compare/v0.20.3-Beta...v0.21.0-Beta

Wrong?

v0.21.2-Beta7 Jul 2026

Install Bash 5 and use the repository's Swift 6.3.2 toolchain when building this release from source.

Action requiredInferredAffects: Users building AeroSpace from source.

Read the evidence

Wrong?

v0.21.2-Beta7 Jul 2026

Replace unframed JSON reads and writes with a four-byte little-endian payload length followed by UTF-8 JSON, in both directions, after the version handshake.

Action requiredInferredAffects: Custom clients using the pre-0.21 unframed JSON socket protocol.

Read the evidence

Wrong?

v0.20.2-Beta4 Jan 2026

The supplied `persistent-workspaces` list drops H, J, K and L; explicitly list them in a custom configuration if needed.

Behavior changedInferred

Read the evidence

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

Wrong?

v0.20.2-Beta4 Jan 2026

The Secure Input notice is suppressed when the active binding mode has no shortcuts.

Behavior changedInferred

Read the evidence

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

Wrong?

v0.20.0-Beta24 Nov 2025

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

Action requiredInferredAffects: Scripts piping workspace lists to workspace-cycling commands.

Read the evidence

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

Wrong?

v0.20.0-Beta24 Nov 2025

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

Behavior changedInferred

Read the evidence

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

Wrong?

v0.20.0-Beta24 Nov 2025

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

Behavior changedInferred

Read the evidence

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

Wrong?

v0.20.0-Beta24 Nov 2025

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 requiredInferredAffects: Users building AeroSpace from source; packaged binaries still run on macOS 13+.

Read the evidence

Wrong?

AeroSpace release history 8

commit 74a1bf11 Oct 2026

Choose whether the next detected window opens floating or tiled.

Details

`layout --for-next-detected-window floating|tiling` schedules one layout override before and after window-detected callbacks; source builds now require swiftly and Swift 6.4.

Unreleased default-branch commit 74a1bf1, after v0.21.3-Beta. Source builds require swiftly and Swift 6.4; debug builds need macOS 14+, release builds macOS 15+ and Xcode 26.6+.

Added: Choose a floating or tiled layout for the next wind…Action required / inferred

Seeded by @iluxav with Codex

Read the evidence

v0.21.3-Beta16 Jul 2026

Use Wispr Flow without having its popups treated as regular tiled windows.

Details

Window detection excludes Wispr Flow windows at non-normal window levels and rejects null window IDs.

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

Now works / inferred: Arrange and resize windows in nested tiles or accor…

Seeded by @iluxav with Codex

Read the evidence

v0.21.2-Beta7 Jul 2026
with v0.21.0-Beta, v0.21.1-Beta

Combine window commands with conditions and pipes in keyboard bindings.

Details

The built-in shell supports sequences, conditions and pipes, with `eval` for CLI use; `subscribe`, `run-callback`, automatic config reload and mouse-driven focus are also available.

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

Added: Combine window-management commands with conditions,…Added: Receive window, focus, workspace, mode and binding…Added / inferred: Focus windows by moving the pointer over them.Improved: Configure keyboard shortcuts and binding modes in a…Improved: Run rules when windows appear and commands when foc…Action required / inferred: Run rules when windows appear and commands when foc…Behavior changed: Run rules when windows appear and commands when foc…Action required / inferred: Configure keyboard shortcuts and binding modes in a…Action required / inferred: Arrange and resize windows in nested tiles or accor…Improved: Arrange and resize windows in nested tiles or accor…Behavior changed / inferred: Configure keyboard shortcuts and binding modes in a…Action required / inferred: Query windows, workspaces, monitors and application…Action required / inferred: Query windows, workspaces, monitors and application…Now works / inferred: Switch between virtual workspaces without animation…Now works / inferred: Focus windows by moving the pointer over them.Now works / inferred: Arrange and resize windows in nested tiles or accor…Now works / inferred: Keep selected windows floating above the tiled layo…Action required / inferredAction required / inferred: Query windows, workspaces, monitors and application…

Seeded by @iluxav with Codex

Read the evidence

v0.20.3-Beta8 Mar 2026

Restore floating windows when returning to their workspace without leaving them stuck in a corner.

Details

Floating-window restoration preserves the saved position across concurrent hide operations and clamps the position to the target monitor's bounds.

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

Now works / inferred: Keep selected windows floating above the tiled layo…

Seeded by @iluxav with Codex

Read the evidence

v0.20.2-Beta4 Jan 2026
with v0.20.1-Beta

Start AeroSpace while it is disabled without crashing on startup commands.

Details

The 0.20.1–0.20.2 patches handle disabled startup commands and built-in configuration loading errors, and adjust the supplied persistent-workspace list.

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

Now works / inferred: Configure keyboard shortcuts and binding modes in a…Behavior changed / inferred: Keep explicitly named workspaces alive when empty a…Behavior changed / inferred: Configure keyboard shortcuts and binding modes in a…Now works / inferred: Arrange and resize windows in nested tiles or accor…

Seeded by @iluxav with Codex

Read the evidence

v0.20.0-Beta24 Nov 2025

Keep chosen workspaces available even when they are empty.

Details

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.

Added: Keep explicitly named workspaces alive when empty a…Action required / inferred: Switch between virtual workspaces without animation…Limit lifted / inferred: Run rules when windows appear and commands when foc…Improved: Query windows, workspaces, monitors and application…Behavior changed / inferred: Adjust or mute system volume from a keyboard bindin…Behavior changed / inferred: Configure keyboard shortcuts and binding modes in a…Improved / inferred: Configure keyboard shortcuts and binding modes in a…Action required / inferredNow works / inferred: Arrange and resize windows in nested tiles or accor…

Seeded by @iluxav with Codex

Read the evidence

v0.19.2-Beta21 Jul 2025
with v0.19.0-Beta, v0.19.1-Beta

Swap a window with its neighbor using the keyboard.

Details

The 0.19 release adds directional and depth-first swaps and configurable move boundaries; its close patch releases fix popup focus and workspace-move exit codes.

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

Added: Swap windows in a direction or in depth-first order.Improved: Arrange and resize windows in nested tiles or accor…Behavior changed / inferred: Move windows and workspaces between monitors.Action required / inferred: Configure keyboard shortcuts and binding modes in a…Improved: Query windows, workspaces, monitors and application…Now works / inferred: Switch between virtual workspaces without animation…Now works / inferred: Arrange and resize windows in nested tiles or accor…Behavior changed / inferred: Keep selected windows floating above the tiled layo…Action required / inferred: Move windows and workspaces between monitors.

Seeded by @iluxav with Codex

Read the evidence

v0.19.0-Beta10 Jul 2025
Starting point

Arrange macOS windows into keyboard-controlled tiling layouts.

Details

Existing capabilities include tiles and accordion layouts, floating windows, emulated workspaces, TOML key bindings, callbacks and CLI queries.

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

Added: Arrange and resize windows in nested tiles or accor…Added: Switch between virtual workspaces without animation…Added: Move windows and workspaces between monitors.Added: Keep selected windows floating above the tiled layo…Added: Configure keyboard shortcuts and binding modes in a…Added: Run rules when windows appear and commands when foc…Added: Query windows, workspaces, monitors and application…Added: Adjust or mute system volume from a keyboard bindin…

Seeded by @iluxav with Codex

Read the evidence