📈 GH Trending Explorer 🎲 Surprise me

← all repos

nikitabobko / AeroSpace

git clone https://github.com/nikitabobko/AeroSpace.git

AeroSpace is an i3-like tiling window manager for macOS

+19
stars, 24h · #1,971
+~89
stars, 7 days · #2,443
+~380
stars, 30 days · #2,181
24k
★ total · +0% this week
760
forks · 236 open issues

Star history (as recorded here)

2026-10-20 · 23,564 ★ 2026-10-23 · 23,602 ★
LanguageSwift
LicenseMIT
Created2023-05-21 (3y ago)
Last push21d ago
Watchers72
OwnerUser

GitHub topics

Links

README excerpt
# AeroSpace Beta 
AeroSpace is an i3-like tiling window manager for macOS
Videos:
- YouTube 91 sec Demo
- YouTube Guide by Josean Martinez
Docs:
- AeroSpace Guide
- AeroSpace Commands
- AeroSpace Goodies
## Key features
- Tiling window manager based on a tree paradigm
- i3 inspired
- Fast workspaces switching without animations and without the necessity to disable SIP
- AeroSpace employs its own emulation of virtual workspaces instead of relying on native macOS Spaces due to their considerable limitations
- Plain text configuration (dotfiles friendly). See: default-config.toml
- CLI first (manpages and shell completion included)
- Doesn't require disabling SIP (System Integrity Protection)
- Proper multi-monitor support (i3-like paradigm)
## Installation
Install via Homebrew to get autoupdates (Preferred)
 [code] 
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:
- #all.
 RSS.
 Feed with all discussions.
- #announcements.
 RSS.
 Only maintainers can post here.
 Highly moderated traffic.
- #announcements-releases.
 RSS.
 Announcements about non-patch releases.
 Only maintainers can post here.
- #feature-ideas.
 RSS.
- #general.
 RSS.
- #potential-bugs.
 RSS.
 If you think that you have encountered a bug, you can discuss your bugs here.
- #questions-and-answers.
 RSS.
 Everyone is welcome to ask questions.
 Everyone is encouraged to answer other people's questions.
## 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:
- [x] https://github.com/nikitabobko/AeroSpace/issues/131 Performance. Implement thread-per-application to circumvent macOS blocking AX API.
- [ ] https://github.com/nikitabobko/AeroSpace/issues/1215 _Big refactoring_. Rewrite mutable double-linked core tree data structure to immutable single-linked persistent tree.
 Important