swm

Stark Window Manager for macOS.

swm is a command-line window manager with optional automatic tiling. One swm process runs as a daemon and tracks applications, displays, spaces, and windows. Other invocations send commands to that daemon.

It is inspired by yabai and replaces the JavaScript configuration used by its predecessor, Stark, with a small shell-based command interface.

Quick start

Requires macOS 26 or later and Accessibility permission for swm.

brew tap starkwm/formulae
brew install starkwm/formulae/swm
brew services start swm

Grant Accessibility permission when prompted. swm starts with a floating layout. Create ~/.config/swm/swmrc to enable tiling and apply settings at startup.

See getting started for requirements and source builds, or the configuration guide for an example startup script.

Documentation

The documentation index links to all guides and command references.

• Command line
• Query state
• Manage windows
• Configure spaces
• Manage displays
• Signals
• Keyboard shortcuts