AeroSpace README

The project's README from github.com/nikitabobko/AeroSpace. As one markdown file: README.md.

AeroSpace Beta Build

AeroSpace is an i3-like tiling window manager for macOS

Videos:

Docs:

Key features

Installation

Install via Homebrew to get autoupdates (Preferred)

brew install --cask nikitabobko/tap/aerospace

In multi-monitor setup please make sure that monitors are properly arranged.

Other installation options: https://nikitabobko.github.io/AeroSpace/guide#installation

[!NOTE] By using AeroSpace, you acknowledge that it's not notarized.

Notarization is a "security" feature by Apple. You send binaries to Apple, and they either approve them or not. In reality, notarization is about building binaries the way Apple likes it.

I don't have anything against notarization as a concept. I specifically don't like the way Apple does notarization. I don't have time to deal with Apple.

Homebrew installation script is configured to automatically delete com.apple.quarantine attribute, that's why the app should work out of the box, without any warnings that "Apple cannot check AeroSpace for malicious software"

Community, discussions, issues

AeroSpace project doesn't accept Issues directly - we ask you to create a Discussion first. Please read CONTRIBUTING.md for more details.

Community discussions happen at GitHub Discussions. There you can discuss bugs, propose new features, ask your questions, show off your setup, or just chat.

There are 7 channels:

Project status

Public Beta. AeroSpace can be used as a daily driver, but expect breaking changes until 1.0 is reached.

What stops us from 1.0 release:

Big and important issues which will go after 1.0 release:

Development

A notes on how to setup the project, build it, how to run the tests, etc. can be found here: dev-docs/development.md

Project values

Values

Non Values

macOS compatibility table

Sponsorship

AeroSpace is developed and maintained in my free time. If you find it useful, consider sponsoring.

People who have write access

In alphabetical order:

Tip of the day

defaults write -g NSWindowShouldDragOnGesture -bool true

Now, you can move windows by holding ctrl+cmd and dragging any part of the window (not necessarily the window title)

Source: reddit

AeroSpace (nikitabobko/AeroSpace)

Searching Database…

23.5K ·GitHub
What is this?AeroSpace is an i3-like tiling window manager for macOS: it arranges your windows into a tree-based tiling layout automatically and adds i3-style workspaces you can switch between instantly from the keyboard.
Does it work on top of native macOS Spaces?No. AeroSpace emulates its own virtual workspaces because macOS Spaces have considerable limitations — that is what enables instant workspace switching with no animations and no SIP changes.
Do I need to disable SIP like with some other tiling window managers?No, and the project promises it will never require that. It sticks to public accessibility APIs — the only private API used is a single call to get a window ID.
Will Gatekeeper complain when I install it?The app is not notarized — the author openly declines Apple's process. The Homebrew install script strips the quarantine attribute, so it runs out of the box without the 'Apple cannot check AeroSpace for malicious software' warning.
Is this made for regular Mac users or for tinkerers?For advanced users and developers: it is keyboard-centric, configured by editing text files, and deliberately skips eye-candy like animations, transparency or window borders.
Which macOS versions does it run on?The binary runs on macOS 13 and newer. Compiling from source needs more: macOS 14+ for debug builds, and macOS 15+ with Xcode 26+ for release builds.
Can I move windows with the mouse too?Yes — hold ctrl+cmd and drag any part of a window, not just its title bar.
Can I customize the look — gaps, animations, a menu bar?Only minimally. AeroSpace offers gaps and a few callbacks for bar integrations; fancy appearance like animations, transparency and window borders is considered impractical, and ricing issues are mostly ignored.
How does it compare to yabai or Amethyst?Those are the alternative macOS tiling window managers: yabai is based on binary space partitioning, Amethyst follows xmonad, while AeroSpace follows the i3 tree paradigm with its own workspace emulation.
What is still on the roadmap?Sticky windows and Dynamic TWM are planned after 1.0. Before that, work continues on performance (thread-per-application) and rewriting the core tree to an immutable structure for stability.
What are similar projects?rift, KiwiDesk, i3, omacosy, komorebi, glazewm, DockDoor, sway
Size
13.3 MB
Stars
23.5K
Updated
CommitOct 01
Age
3y
Commits · 90 Days