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.

Development is happening on macOS Mojave (10.14), but OSX El Capitan (10.11.6) and newer should work fine. Older versions may or may not be compatible and will not be 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.