diff --git a/pages/osx/yabai.md b/pages/osx/yabai.md
new file mode 100644
index 000000000..7feb1f6ec
--- /dev/null
+++ b/pages/osx/yabai.md
@@ -0,0 +1,24 @@
+# yabai
+
+> A tiling window manager for macOS based on binary space partitioning.
+> More information: <https://github.com/koekeishiya/yabai>.
+
+- Set the layout to bsp:
+
+`yabai -m config layout {{bsp}}`
+
+- Set the window gap to 10pt:
+
+`yabai -m config window_gap {{10}}`
+
+- Enable opacity:
+
+`yabai -m config window_opacity on`
+
+- Disable window shadow:
+
+`yabai -m config window_shadow off`
+
+- Enable status bar:
+
+`yabai -m config status_bar on`