koekeishiya

yabai: Tile and Control macOS Windows from the Command Line

yabai is a macOS window manager for people who want automatic tiling and command-line control over windows, spaces, and displays. It suits users comfortable configuring macOS permissions and, for some advanced features, changing System Integrity Protection settings.

View on GitHub Compare
Stars
29.7k
Forks
777
Stars, last 30 days
+100

Our take

Health score

44/100

How it is scored
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.

Selected snapshot

Stars

29,841

Forks

819

Change 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

  • AeroSpace: AeroSpace uses its own virtual workspaces and does not require disabling SIP for its window-management features.
  • Amethyst: Amethyst offers automatic tiling with xmonad-inspired layouts and keyboard controls, rather than yabai’s command-line-centered configuration.
ProjectLanguageLicenseStarsStatus
yabaiCMIT29.7kNot checked yet
AeroSpaceSwiftMIT23.3kActive
AmethystSwiftMIT16.3kActive

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.

Comparisons