Spacetile tiles windows on native macOS Spaces, yabai style, with System Integrity Protection left on. It’s a menu-bar app driven by the keyboard and the mouse, built and tested on macOS 27 and needs macOS 26 or later.
- Windows on each Space tile as a binary space partition (BSP). New windows split the focused tile.
- Spaces are the real Mission Control ones, so ⌥1…⌥0 switch between them instantly and ⌥⇧1…⌥⇧0 send windows to them.
- Profiles save and restore an arrangement across Spaces, by hand, by shortcut, when a display connects, or when a Focus turns on.
- Everything is configured in
~/.config/spacetile/and edited either in Settings or by hand.
Documents
| Document | What it covers |
|---|---|
| Features | Everything Spacetile does, and how it fits with Spaces, full screen and macOS tiling |
| Commands | Every action, its default key and its spacetile-ctl form |
| Mouse | Focus follows mouse, drag to retile, resizing, fn shortcuts, drop overlays |
| Spaces and layouts | Switching and sending, layout modes, stack on overflow, holes, Space counts |
| Profiles | Capturing, designing and applying profiles; the profile file format; Focus filters |
| Configuration | config.json, rules, the menu-bar item and each Settings tab |
| Setup | Building, signing, permissions, macOS settings, developer commands and limits |
To see how Spacetile compares with yabai, AeroSpace, Rectangle, ShiftPlus and other window and workspace managers, see Spacetile compared.
The design and the history behind it are in PLAN.md.