Deprecation notice

chunkwm is no longer in development because of a C99 re-write, yabai.

yabai was originally supposed to be the first RC version of chunkwm. However due to major architectural changes, supported systems, and changes to functionality, it is being released separately. There are multiple reasons behind these changes, based on the experience I've gained through experimenting with, designing, and using both kwm and chunkwm. Some of these changes are performance related while other changes have been made to keep the user experience simple and more complete, attempts to achieve a seamless integration with the operating system (when possible), proper error reporting, and yet still keep the property of being customizable.


chunkwm is a tiling window manager for macOS that uses a plugin architecture, successor to kwm. It represents windows as the leaves of a binary tree, and supports binary space partitioned, monocle and floating desktops.

chunkwm is supported on macOS High Sierra (10.13.6) and Mojave (10.14.5). Older versions may or may not be compatible and is not officially supported.

chunkwm uses a pid-file stored as /tmp/chunkwm_$USER-pid to keep multiple instances from being launched by the same user.

chunkwm uses a unix domain socket stored as /tmp/chunkwm_$USER-socket to listen for runtime commands.

chunkc is a program that writes messages on chunkwm's socket.

chunkwm does not handle any keyboard input.
A third party program (e.g: skhd) is needed to map keyboard events to chunkwm actions.

For instructions on how to install chunkwm, visit the user's guide.

If you later decide that you no longer want to use chunkwm, it can easily be removed without leaving any trace. The method of uninstalling differs depending on the installation method of your choice. Both brew and macports are trivial to use for this purpose.

Both of my tiling window managers (kwm and chunkwm) have been heavily inspired by bspwm, and I'd like to thank baskerville for his project and for introducing me to an interesting tiling concept.