Overflow scrolls
Apps refuse to shrink below their minimum, so KiwiDesk stops there. Stack, Track, Grid and BSP scroll the rest; a “+n” overflow mark counts what’s hidden — click it for the list.
No container tree to nest or flatten — one window list per Space, seven layouts over it, a Settings app with Lua underneath. And it never disables SIP.
Free to use · License ↗ · written in Swift and Lua · signed and notarized · macOS 14+, Apple silicon
“Tiling managers were always a nerd’s toy. I wanted to make them intuitive for everyone – it should just work, like that.”
“I wanted a window manager that works with you — not one you have to tell how to work.”
Seventy seconds of KiwiDesk doing the thing: five messy windows tiled in one step, the scrolling layout, a window dragged onto the Space Bar, a sticky window that follows you, and one profile per macOS Desktop.
Watch on YouTube ↗Every feature, one clip each ↗Where it all began ↗
“Fair warning: you'll open windows on purpose, just to watch them snap into place.”
100% juice, no filler.
KiwiDesk is my go-to window manager. The developer is responsive, friendly, and has a clear vision for the app. And yet, KiwiDesk has so many options and is so flexible that it immediately replaced the more opinionated window managers I had.

KiwiDesk is the best tiling window manager on the Mac, hands down! The more I use it and the more its feature set grows, the less I find myself turning to Linux.

After trying about a dozen popular window managers and even attempting to build my own, KiwiDesk is the closest I’ve found to the “perfect” window manager for me. I love how customizable it is, and the Space Bar is a killer feature that solves so many of the frustrations I had with the others.

This is where people should start with macOS tiling managers. While I love Rift and Amethyst — had I known this existed, I would have never needed to go through the trial and error.
A flat, one-dimensional window model — and everything fast, scriptable, and safe that falls out of it.
Apps refuse to shrink below their minimum, so KiwiDesk stops there. Stack, Track, Grid and BSP scroll the rest; a “+n” overflow mark counts what’s hidden — click it for the list.
bsp, stack, scrolling, monocle, grid, track and floating all read one flat window list per Space — no containers to nest or flatten. ⌃⌥C steps through the ones you pick.
⌃⌥V dims and blurs every window but the focused one. Lenses keep the apps you choose clear, each on its own shortcut and in the profiles you pick.
⌃⌥J jumps to any window by name, ⌃⌥K lists every shortcut, ⌃⌥L switches layout, profile or KiwiVision — one panel that never steals focus from your app; Tab steps between sides.
kiwidesk mcp serves KiwiDesk's verbs to Claude Desktop, Claude Code, Cursor or Codex. Describe the desk you want; most changes stay temporary until you say keep.
Set the Space Bar and App Bar to Always, Auto or Hidden, each on its own. On Auto a bar stays out of the way until the pointer reaches its edge; ⌃⌥G and ⌃⌥H bring it in by key.
One window, one key away. ⌃⌥P tucks it out of sight; press it again on any Space and it’s right there, floating over your work.
⌃⌥M fills the screen with the focused window and hides the bars — no full-screen Desktop. Press it again, or focus another tiled window, and it’s back in its slot.
Send a window to Desktop 3, switch to it, or bind a profile so a Desktop brings its own Spaces with it.
After a restart or logout, windows return to their Spaces. Sync across Macs keeps profiles, looks and init.lua in step through iCloud Drive or any synced folder.
No kernel extension, no Input Monitoring. Shortcuts run through Carbon, the Hyper key through hidutil. Only a left- or right-side shortcut you opt into starts a keyboard tap — and it records nothing.
Private OS symbols resolve at runtime and every tiling path has a public Accessibility fallback — an update can slow a fast path, never break the tiling.
Switch or merge tabs in Finder, Safari or Terminal and your layout holds. To a window manager every macOS tab is a separate window — where tiling usually breaks.
A sticky window follows you across every Space — or just the one screen it lives on. A mark on the window and a badge in the Space Bar show you which.
A sandboxed Lua 5.5 VM reads ~/.config/KiwiDesk/init.lua. A broken config can’t freeze your windows — a 500 ms watchdog guards it.
Script everything. Stream events to SketchyBar, JankyBorders, or your own tools over a socket.
Every control announces its name and its value under VoiceOver, and Settings can be driven entirely from the keyboard — with macOS’s Keyboard navigation on.
One display link per screen, so mixed 60 / 120 Hz setups each animate at their own cadence. Space switches slide, show the Space, or just change — your pick.
Every layout is a pure function over the same flat array — so switching is instant and predictable.
Binary space partitioning: each new window halves a pane.
A master zone beside a stack column.
Niri / PaperWM scrolling columns or rows.
Focused window maximized, rest behind.
Dynamic or rigid rows × columns.
Columns or rows; every resize has one true target.
The macOS default, left untouched.
Prefer text to sliders? Drop real Lua into ~/.config/KiwiDesk/init.lua and it takes over — layouts, gaps, keybindings, all as code, running in a sandboxed Lua 5.5 VM behind a 500 ms watchdog so a typo can never freeze your windows.
-- ~/.config/KiwiDesk/init.lua
KiwiDesk.set_gap_global(10)
KiwiDesk.set_mode("music", "floating")
-- one flat array per space, tidy by default
KiwiDesk.bind("cmd+alt+left", function()
KiwiDesk.focus("left")
end)Every action is a command. Bind them to keys, script them, stream live events over a Unix socket into SketchyBar, JankyBorders, or your own tools — or let your AI app drive the same commands through kiwidesk mcp.
“The day my window manager became scriptable, my desktop started running itself. I haven't dragged a window since.”
$ kiwidesk set_mode monocle
$ kiwidesk focus left
$ kiwidesk get_state
# stream live events (feed SketchyBar, your own tools…)
$ kiwidesk subscribe space_changeEvery look is a JSON file in a public GitHub repo, shared under CC BY 4.0. A kiwidesk:// link adds one to the app, and kiwidesk preview renders yours as a card before you share it.
{
"format": 2,
"look": {
"name": "Purple Dreams",
"colors": {
"border.focused_color": "#564AB6",
"kiwishelf.fill_color": "#1A1A2EA5",
"kiwishelf.active_item_color": "#B38ED9",
…
},
"style": {
"border.width": 5,
"kiwishelf.corner_roundness": 100,
"space_bar.edge": "top",
…
}
}
}
$ kiwidesk preview purple-dreams.json purple-dreams.png“Even though I'm perfectly comfortable in the terminal, I got tired of having to constantly track container nesting just to arrange my windows the way I want. KiwiDesk keeps everything flat. No unnecessary overhead, no distractions: just pure focus on my projects.”
Prefer a package manager? One command, and the kiwidesk CLI lands on your PATH. Either way KiwiDesk keeps itself up to date from there.
Read the DocsThe signed, notarized disk image is the same app — after installing it that way you link the kiwidesk CLI onto your PATH yourself, which the CLI guide covers.
$ brew install --cask kiwicanopy/tap/kiwidesk
# the kiwidesk CLI lands on your PATHFree to use · License ↗ · written in Swift and Lua · signed and notarized · macOS 14+, Apple silicon
programs.kiwidesk.enable = true;
# updates arrive with home-manager switchThe flake input and module import are in the KiwiCanopy/nix README
$ git clone https://github.com/KiwiCanopy/KiwiDesk.git
$ cd KiwiDesk
$ swift build -c release
# for contributors — Homebrew is the easy pathDownload KiwiDesk, or install it with Homebrew — it’s the same signed build either way, and it keeps itself up to date from there.
Free to use · License ↗ · written in Swift and Lua · signed and notarized · macOS 14+, Apple silicon
KiwiDesk's source is public — a star on GitHub helps other people find it.
“They say an apple a day — but the kiwi's got more vitamins and bigger plans... 🥝”