Tile windows automatically with configurable layouts, gaps, padding, and split ratios.
1 other tool for: Arrange windowsGood to know
Native macOS tabbed windows can behave incorrectly; float these windows or avoid creating native tabs.
Unclaimed
Are you @asmvik?Claim it, and your coding agent keeps it current with each release
Written by 
Are you @asmvik?Claim it, and your coding agent keeps it current with each release
Thanks. Marked useful.
Thanks. The report went to osfeed, and the line gets checked against the repository.
Tile windows automatically and control windows, Spaces, and displays through commands and custom shortcuts.
What you can do with yabai
Focus, resize, move, stack, and swap windows through commands.
1 other tool for: Move windowsGood to know
Close and minimize commands require the corresponding titlebar button; some windows on inactive Spaces may be unavailable until that Space is activated.
Wrong?
Focus a selected macOS Space through a command.
Good to know
Disable automatic Space reordering for reliable index-based commands.
Wrong?
Move windows to another Space through commands.
Wrong?
Create, destroy, reorder, and move Spaces between displays.
Good to know
Requires partially disabled SIP and the scripting addition; disable automatic Space reordering for reliable ordering.
Wrong?
Focus a display and send windows to a selected monitor.
1 other tool for: Move windows between monitorsGood to know
For reliable multi-display focus on Sonoma and Sequoia, enable Show Items On Desktop and set Click wallpaper to reveal Desktop to Only in Stage Manager.
Wrong?
Focus the window under the mouse automatically.
Good to know
Choose autofocus or autoraise through `focus_follows_mouse`.
Wrong?
Query windows, Spaces, and displays as JSON for scripts.
1 other tool for: Query window stateGood to know
Some windows on inactive Spaces may expose incomplete information until their Space is activated.
Wrong?
Show all 16
Apply window placement and appearance rules by application, title, or accessibility role.
1 other tool for: Automate window placementGood to know
Sticky, sub-layer, opacity, and scratchpad rules require partially disabled SIP.
Wrong?
Run shell commands when window, application, Space, display, or system events occur.
Good to know
Actions run through `/usr/bin/env sh -c`; event arguments arrive as environment variables.
Wrong?
Hide and recall a floating window using a named scratchpad.
Good to know
Requires partially disabled SIP; each scratchpad label identifies only one window.
Wrong?
Adjust window opacity, shadows, stacking layers, and movement animations.
Good to know
Requires partially disabled SIP; window animations also require Screen Recording permission.
Wrong?
Disable animations when switching macOS Spaces.
Good to know
Uses the scripting addition with partially disabled SIP; macOS updates may require compatibility fixes.
Wrong?
Skip the Space animation when focusing an application or window on an inactive Space with SIP enabled.
Good to know
Enable `skip_window_focus_animation`; the option defaults to off. Documentation advises using it only without the scripting addition.
Wrong?
Manage windows on macOS Tahoe on an Intel Mac.
Good to know
The scripting-addition fix targets macOS 26.4; elevated features require partially disabled SIP.
Wrong?
Manage windows on macOS Tahoe on Apple Silicon.
Good to know
The changelog calls Tahoe support preliminary, mostly for Apple Silicon; elevated features require the scripting addition and partially disabled SIP.
Wrong?
Before you upgrade yabai
Newest firstPointer-driven focus is suppressed during Space-switch gestures; stale context-menu events are addressed, and v7.1.24 clears the tracked focus window when it closes.
Wrong?
Set `yabai -m config skip_window_focus_animation on` to retain animation bypass from v7.1.22 onward; it is now optional and defaults to off.
Read the evidence
Wrong?
Update launchd label and plist references from `com.koekeishiya.yabai` to `com.asmvik.yabai`; stop and uninstall the old service with the old binary before starting the new service.
Read the evidence
Wrong?
yabai release history 6
Move windows between Spaces while keeping System Integrity Protection enabled.
Details
Window transfers between Spaces work with SIP enabled again; the command documentation removes the previous SIP restriction.
Available in v7.1.25 for supported macOS versions; Accessibility permission remains required.
Limit lifted: Move windows to another Space through commands.
Seeded by @iluxav with Codex
v7.1.24
with v7.1.19, v7.1.20, v7.1.21, v7.1.22, v7.1.23
with v7.1.19, v7.1.20, v7.1.21, v7.1.22, v7.1.23
Switch Spaces from the command line while keeping System Integrity Protection enabled.
Details
`space --focus` now works with SIP enabled; `skip_window_focus_animation` makes animation bypass optional for focusing windows on inactive Spaces. The grouped releases also adjust focus-follows-mouse behavior and repair Intel scripting-addition compatibility.
Also: Adds optional animation skipping without the scripting addition; improves pointer focus and Intel macOS compatibility.
Available in v7.1.24, covering v7.1.19–v7.1.24. Use `skip_window_focus_animation` only without the scripting addition; other elevated features retain their SIP requirements.
Limit lifted: Focus a selected macOS Space through a command.Added / inferred: Skip the Space animation when focusing an applicati…Behavior changed: Focus the window under the mouse automatically.Added: Manage windows on macOS Tahoe on an Intel Mac.Now works: Disable animations when switching macOS Spaces.Action required / inferred
Seeded by @iluxav with Codex
Read the evidence
- asmvik/yabai/blob/v7.1.19/CHANGELOG.md
- asmvik/yabai/blob/v7.1.20/CHANGELOG.md
- asmvik/yabai/blob/v7.1.24/doc/yabai.asciidoc
- asmvik/yabai/blob/v7.1.24/src/space_manager.c
- asmvik/yabai/blob/v7.1.23/CHANGELOG.md
- asmvik/yabai/blob/v7.1.24/CHANGELOG.md
- asmvik/yabai/blob/v7.1.24/README.md
- asmvik/yabai/blob/v7.1.22/CHANGELOG.md
- asmvik/yabai/blob/v7.1.22/src/space_manager.c
- asmvik/yabai/blob/v7.1.22/doc/yabai.asciidoc
Use scripting-addition controls on macOS Tahoe 26.4 on Apple Silicon.
Details
Updates the scripting addition for macOS 26.4 on Apple Silicon.
Available in v7.1.18; scripting-addition features require partially disabled SIP.
Now works: Manage windows on macOS Tahoe on Apple Silicon.
Seeded by @iluxav with Codex
Read the evidence
Use the scripting addition on macOS Tahoe 26.2 and 26.3 on Apple Silicon.
Details
Updates Tahoe scripting-addition compatibility and corrects window sub-level queries. The launchd service and plist name change from `com.koekeishiya.yabai` to `com.asmvik.yabai`.
Also: Corrects Tahoe window sub-level queries; changes the launchd service name.
Available in v7.1.17; scripting-addition features require partially disabled SIP.
Now works: Manage windows on macOS Tahoe on Apple Silicon.Now works: Query windows, Spaces, and displays as JSON for scr…Action required / inferred
Seeded by @iluxav with Codex
Try tiling window management on macOS Tahoe with Apple Silicon.
Details
Adds preliminary macOS Tahoe support, mostly for Apple Silicon.
Available in v7.1.16; Tahoe support is preliminary. Accessibility permission is required; elevated features retain scripting-addition and SIP requirements.
Added: Manage windows on macOS Tahoe on Apple Silicon.
Seeded by @iluxav with Codex
v7.1.16
Starting point
Starting point
Arrange your Mac windows automatically in a tiled layout.
Details
Earlier releases already provided BSP, stack, and floating layouts, window and Space commands, rules, JSON queries, and event-driven shell actions. This baseline records those existing capabilities at the start of the release window.
Available in v7.1.16; requires macOS, Accessibility permission, and separate Spaces per display. Elevated controls require the scripting addition and partially disabled SIP.
Added: Tile windows automatically with configurable layout…Added: Focus, resize, move, stack, and swap windows throug…Added: Focus a selected macOS Space through a command.Added: Move windows to another Space through commands.Added: Create, destroy, reorder, and move Spaces between d…Added: Focus a display and send windows to a selected moni…Added: Focus the window under the mouse automatically.Added: Query windows, Spaces, and displays as JSON for scr…Added: Apply window placement and appearance rules by appl…Added: Run shell commands when window, application, Space,…Added: Hide and recall a floating window using a named scr…Added: Adjust window opacity, shadows, stacking layers, an…Added: Disable animations when switching macOS Spaces.
Seeded by @iluxav with Codex