yabai

Automate macOS window management via yabai's CLI for tiling and scripting.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/quantmind-br/skills --skill yabai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yabai
Source: https://github.com/quantmind-br/skills/tree/main/yabai
Command: npx skills add https://github.com/quantmind-br/skills --skill yabai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Yabai provides a native tiling window manager for macOS, enabling automated layout of windows, spaces, and displays via a powerful CLI to streamline multitasking and workflows.

Core Features & Use Cases

  • Tiling and space management: arrange windows using binary space partitioning across multiple displays for predictable layouts.
  • CLI-driven control and scripting: query, move, resize, focus, and configure windows, spaces, and displays from scripts or shells for automation.
  • Configuration and troubleshooting workflow: install, load scripting additions, manage the yabai service, and customize yabairc for repeatable setups.

Quick Start

Install yabai via the installer script or Homebrew, grant accessibility permissions, start the service, load the scripting addition if required, and create your yabairc configuration.

Frequently Asked Questions about yabai

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS window management across multiple displays?

Automate macOS window management by using yabai's CLI to query, move, resize, and configure windows across multiple displays. This enables programmable window layouts and space orchestration through scriptable commands.

What is tiling window management on macOS and how does binary space partitioning work?

Tiling window management on macOS arranges windows automatically into non-overlapping tiles using binary space partitioning. This creates predictable layouts by splitting screen space recursively as new windows open.

How do I configure yabairc and load scripting additions on macOS?

Configure yabairc and load scripting additions by installing yabai, granting accessibility permissions, starting the service, and customizing the configuration file. This ensures repeatable setups and robust scriptable automation.

Does yabai work with multi-display macOS setups for space orchestration?

Yabai works with multi-display macOS setups to provide space and display orchestration. It queries and controls spaces and displays directly from scripts or shells for automated layout management.

Why is my yabai scripting addition not loading or working properly?

If the yabai scripting addition is not loading, troubleshooting involves verifying installation, checking accessibility permissions, ensuring the service is running, and validating the scripting addition is correctly loaded for robust automation.