Our take
- Activity
- 41
- Community
- 15
- Issues
- 76
- Pull requests
- no data
+100 stars in the last 30 days
- Closes issues faster than 82% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
29,841Forks
819Change since Nov 16, 2026: -1 stars·+1 forks
Overview
yabai extends macOS's built-in window manager with command-line controls for windows, spaces, and displays. Its main purpose is to arrange windows automatically using binary space partitioning, helping users manage screen space without manually resizing and moving each window.
It is aimed at Mac users who prefer keyboard-driven workflows and configurable window layouts. Keyboard shortcuts can be set up separately with skhd or other software.
Key Features
- Automatically tiles windows using binary space partitioning.
- Provides command-line control of windows, spaces, and displays.
- Supports focus-follows-mouse behavior.
- Can disable animations when switching spaces.
- Can create spaces beyond the usual limit of 16.
- Works with optional third-party software for user-defined keyboard shortcuts.
Use Cases
- Developers who want editor, terminal, and documentation windows arranged automatically while working.
- Keyboard-focused Mac users who want to control window focus and layout through shortcuts.
- Users with multiple displays who want command-line control over displays and spaces.
- Mac power users who need capabilities beyond standard window arrangement and are willing to configure system permissions.
Getting Started
See the README and installation wiki for installation methods and setup instructions. Sample configuration files are available in the examples directory.
Alternatives
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| yabai | C | MIT | 29.7k | Not checked yet |
| AeroSpace | Swift | MIT | 23.3k | Active |
| Amethyst | Swift | MIT | 16.3k | Active |
Considerations
- yabai is for macOS, with supported versions varying by Intel or Apple Silicon hardware. Check the README for the listed operating-system requirements.
- It requires Accessibility permission and a restart after permission is granted. Screen Recording permission is needed only for window animations.
- Some advanced features require partially disabling System Integrity Protection to inject a scripting addition into Dock.app. This is optional, and the project cautions users to understand the risks before changing this setting.
- Building from source or installing from HEAD requires code signing to retain accessibility and automation privileges after updates or rebuilds.
- Reliable space and display controls depend on certain macOS Mission Control and Desktop & Dock settings. Consult the README for version-specific caveats.
Found this useful?
Share it with someone who would like yabai.