Skip to content

KiwiDesk Release Notes

Tiling window manager that arranges macOS windows as you open them.

CaskUtilitiesAuto-updates 260
Install command
brew install --cask kiwidesk
30-day installs
89
#971 in App
1-year installs
89
Last 365 days
Latest version
5.0.2
Download size
19MB
zip
Release cadence
Weekly
7 releases in 30 days
  1. 5.0.2

    LatestPatch

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 14 or later

    KiwiDesk 5.0.2, released 20 November 2026, makes the KiwiHub switcher easier to steer from the keyboard and the Desktop overview easier to read for people who tile Mac windows. Official notes: https://github.com/KiwiCanopy/KiwiDesk/releases/tag/v5.0.2

    Switcher
    Left and Right step the app strip while Option stays held from Option-Tab.
    Overview
    Hovering a window icon in the Desktop overview shows that window's title.
    Polish
    KiwiHub search and app-strip window counts are easier to read.The Classic look's card no longer looks washed out.A no-key gesture reads Gesture only, and its Natural scrolling row lines up.

    KiwiDesk 5.0.2 makes KiwiHub easier to read and to steer from the keyboard for people who tile windows on a Mac, with small UI polish. Released 20 November 2026. Official notes: https://github.com/KiwiCanopy/KiwiDesk/releases/tag/v5.0.2

    • In the window switcher, Left and Right now step through the app strip while Option is still held from Option-Tab, as Up and Down already moved through the list.
    • Resting the pointer on a window's icon in the Desktop overview now shows the window's title above it. The tooltip it had before never appeared.
    • KiwiHub's search prompt and the app strip's window counts are easier to read.
    • The Classic look's card no longer looks washed out.
    • A gesture that needs no keys reads "Gesture only", and the gesture cards' Natural scrolling row lines up with the rows under it.
  2. 5.0.1

    Patch

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 14 or later

    KiwiDesk 5.0.1 lets Mac window users stop the Pocket appearing on every drag, and parks it as a handle over a maximized window.

    Improved
    The Pocket can stay hidden while you drag a window.
    Fixed
    Over a maximized window the Pocket rests as its edge handle.

    KiwiDesk 5.0.1, released on November 20, 2026, lets people who tile Mac windows stop the Pocket appearing on every window drag, and parks it as a handle over a maximized window. Official notes: https://kiwidesk.kiwicanopy.com/changelog/#v-v5.0.1

    • You can keep the Pocket from coming out every time you drag a window: untick KiwiShelf, Show, Each bar and Pocket, Show the Pocket while dragging a window. Its keys and its list still bring it in.
    • Over a maximized window the Pocket now rests as its handle at the screen edge, in its usual spot, and comes in from there, instead of sliding out a short way in from the edge.
  3. 5.0.0

    GitHub Release Added to Homebrew

    CompatibilitymacOS 14 or later

    Image: KiwiDesk 5.0.0

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    One of KiwiDesk's biggest updates: far more it can do, and just as easy to use.

    Spotlight

    • Every Desktop at a glance — Replaces Mission Control: every Desktop with all its Spaces; drag windows. {symbol:rectangle.stack}
    • Gestures on trackpad and mouse — Swipe, tap, pinch and drag to move focus, Spaces and windows. {setting:config.gesture} {symbol:hand.draw}
    • Keys that lead to more keys — Press a chord, then pick the next key from the panel it opens. {symbol:keyboard}
    • Bars, reworked — A handle as thin as 2 pt, in reach even over a maximized window. {setting:settings.spaceBarStyle.visibility} {symbol:menubar.rectangle}
    • Place windows your way — Leave a Space untiled with ⌃⌥T; let a Maximize follow focus. {setting:keybinding.toggle_tiling} {symbol:square.grid.2x2}

    New

    • New: KiwiHub's Desktop overview (⌃⌥O) shows every screen's Desktops and the Spaces on each. Jump to a Space, or pick windows up and drop them on another Desktop, by key or by dragging their icons.
    • New: trackpad and mouse gestures, set under Shortcuts ▸ Mouse & Trackpad. With ⌃⌥ held, two fingers move focus, three switch Spaces, four move to the next screen and rotating cycles the layout; drag anywhere inside a window to move it, or add ⇧ to resize it from the nearest corner or edge; and the mouse wheel, sideways wheel and side buttons take gestures too. A three-finger tap now goes back to your last Space and a four-finger tap turns KiwiVision on or off, and either can be turned off on the Trackpad card.
    • New: key sequences, under Shortcuts ▸ Personal. A chord opens a panel of keys, and each key runs an action or opens more keys; any shortcut can now also be a modifier tapped once or twice, such as ⌘⌘, and with Tell left and right modifiers apart on, a Sides menu picks which key a shortcut takes.
    • New: ⌃⌥T turns tiling off for the Space you're on, and back on. Windows stay where you put them and return to their places afterwards; Shortcuts ▸ Built-in ▸ Size & float sets whether the bars and the focus border hide meanwhile.
    • New: a Maximize can now follow focus, moving to the window you focus instead of ending (Layout Defaults ▸ Maximize ▸ Maximize follows focus), and Monocle can maximize every window (Layout Defaults ▸ Monocle ▸ Maximize windows).
    • New: KiwiVision can maximize the window you focus while it is on, and a lens can open its apps when you turn it on.
    • New: App Rules ▸ Open in a Space can match part of a window's title, so one browser profile's windows open in their own Space, and an app with no bundle ID can now have rules too.
    • New: Animation speed, from Off to Fast, at the top of Looks & Animations ▸ Animations and on Simple. It sets one pace for every profile, while each profile keeps its own on/off switches; the separate window, scroll, Space slide and KiwiVision fade lengths have left Settings for it.
    • New: Settings ▸ Profiles ▸ Known screen setups lists the screen combinations KiwiDesk remembers and lets you forget one, and Settings ▸ Screens now offers to shift a screen whose hidden windows would show on its neighbour.
    • New: Report a problem in Settings' footer opens a bug report with your versions filled in.

    Improved

    • An Auto bar now rests as a thin handle along its edge, leaving that room to your windows, and opens as a fill runs along it. The Space dots are gone; set the handle's colour under Looks & Animations ▸ Colors & glass and its thickness, from 2 to 6 pt, beside the bars' Show. The Pocket's tab takes the same thickness.
    • The bars no longer vanish while a window is maximized: they stay off the window, and pointing at a bar's screen edge brings it in. To keep them away, untick Layout Defaults ▸ Maximize ▸ Show bars at the screen edge.
    • Maximize Height now fills 1280 pt across by default on Widescreen, Ultrawide and Super Ultrawide screens, and a share can be a fraction or a length in points, set per screen shape or for one Space. Floating windows and a pocket window that is out can now be maximized as well.
    • A few gesture defaults changed: with a mouse, ⌃⌥ and the sideways wheel now switch Spaces in place of ⌃⌥⌘ and the wheel; on BSP, Stack, Grid and Track a ⌃⌥ swipe now moves focus the way your fingers go; and long two-finger swipes are on for everyone, with their checkbox and a new Step length slider at the foot of the Trackpad card; every window costs the same finger travel, however fast you swipe.
    • Shortcuts & Gestures is now one Home tile, Shortcuts, in three parts: Built-in, Personal and Mouse & Trackpad. The Layers card is a strip of chips, and a layer's icon now shows on its chip and its switch rows.
    • The welcome tour is easier to follow. Its Spaces step lets you start from Suggested, Developer, Focus, Dashboard or Studio and shows the result before anything is saved; its gestures step shows your trackpad and mouse gestures as the glyphs KiwiHub uses; and a Back button returns to the step before. Settings ▸ Profiles no longer has a Presets section.
    • The Pocket's edge can now differ per screen, and Bars ▸ Position places it with the bars; revealing a bar no longer brings the Pocket along.
    • KiwiHub's window switcher now has a strip of apps to narrow the list to one app, and its footer spells out Swap here.
    • An open Settings window now shows changes made from Lua, the CLI or a bar menu, marks the rows that apply at once in every profile, and asks before Restore Defaults changes another profile.
    • A floating window now keeps its size: a bar at the top only moves it down.
    • KiwiDesk is now in Homebrew's own cask list, so brew install --cask kiwidesk installs it without a tap.

    Fixed

    • Update Available… now offers the newest update rather than one found earlier, and the update windows no longer show a black bar at the bottom in dark mode.
    • A window an app opens behind you no longer takes the focus border, and clicking a window's minimize button just after pointing at it no longer brings the window straight back.
    • Unplugging a screen no longer leaves you on an empty Space while your window sits in another.
    • A launching app's popups now follow it to its App Rule's Space, and a launcher or switcher window, such as Zephium's, is no longer tiled now and then.
    • A window at its largest size no longer leaves an empty gap beside it in Stack, BSP or Grid, and fast focus steps in a Scrolling row no longer show the wrong window.
    • The hidden windows of a screen stacked above another no longer show on the screen below.
    • Hovering a bar on the left or right edge now picks the item under the pointer, and a growing Space Bar chip's glass no longer trails behind it.
    • The app picker now lists apps open on every Space and Desktop.
    • Moving a window that is in macOS full screen to another Space or screen is now refused with a message on the window.
    • A shortcut on ⌃⌥Space or ⌃Space now says what really happens: most take the keyboard-language switch from macOS; a plain ⌃Space shortcut runs alongside macOS's, so Settings asks you to turn macOS's off first.

    Lua & CLI

    • If you write your own Lua config: scroll_gesture.set_pan and scroll_gesture.set_space_step are retired for gesture.bind, and scroll_gesture.set_step_distance for set_step_length, in mm; each fails, naming its replacement. The animation lengths (animations.set_duration and its siblings) now set one value for every profile, and set_reveal_duration and set_expand_duration no longer take 0: use animations.set_on_reveal and set_on_expand.
    • New verbs: gesture.bind and gesture.unbind; toggle_tiling and set_tiling; move_to_display and move_to_display_last, each with _and_follow; focus_space_last; focus_app_window; open_in_background, which opens an app behind you, optionally into a Space or a macOS Desktop; shortcut.set_sequence_key and its siblings; titled_app_rules; forget_monitor_set; maximize.set_follow_focus; kiwishelf.set_pocket_edge for one screen; and kiwishelf.set_handle_thickness.
    • kiwidesk mcp now serves the docs the app ships, through docs_search and docs_get, and help and list_commands link each command to its section.
    • An init.lua that only defines a KiwiVision lens is no longer overwritten by Settings on first launch.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v4.2.1...v5.0.0

  4. 4.2.1

    Expand

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 14 or later · Native on Apple silicon

    KiwiDesk 4.2.1 numbers a second screen's Desktops the way Mission Control does.

    Fixed
    A second screen's Desktops now use Mission Control's numbers.

    KiwiDesk 4.2.1, released on November 8, 2026, numbers Desktops the way Mission Control does for people who tile windows across more than one screen.

    With Displays have separate Spaces on, KiwiDesk counted each screen from 1. KiwiHub, the Desktop switch plate, and Settings could name Mission Control's Desktop 8 as Desktop 2. Shortcuts and commands already used Mission Control's number and are unchanged.

    Official notes: https://github.com/KiwiCanopy/KiwiDesk/releases/tag/v4.2.1

  5. 4.2.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 4.2.0 makes more room and puts more within reach: a window fills one side, neighbours make way, and your pocket is one key away.

    Before you update: If you picked None or Show under Space switches, the mouse and trackpad scroll step now slides. To keep your choice there, change Looks & Animations ▸ Animations ▸ Step between Spaces (mouse or trackpad). If a script of yours reads KiwiDesk's replies or events, some of their keys are renamed; Lua & CLI lists them.

    Spotlight

    • Tall or wide — ⌃⌥⇧M fills the height, ⌃⌥⌘M the width, sized per screen. {setting:keybinding.maximize} {symbol:macwindow}
    • Swap it in — In KiwiHub, ⌥↩︎ swaps the window you picked into your spot. {symbol:macwindow.on.rectangle}
    • Room to grow — Grow a window and its neighbour joins the ones waiting behind +n. {symbol:rectangle.split.3x1}
    • Your pocket, one key away — Give an app a Pocket key; ⌃⌥⌘P lists what's inside. {setting:keybinding.pocket} {symbol:tray.full}
    • Black and deep green — Settings' new dark mode, and tiles that lift under the pointer. {setting:UserDefaults.appearance} {symbol:circle.lefthalf.filled}

    New

    • New: an app can now have its own Pocket key. Give an app its own Pocket key… in Shortcuts & Gestures ▸ Pocket adds a key that opens its window (launching the app if needed), puts it away and takes it out again; the pocket's list shows these windows under Pocket Keys.
    • New: ⌃⌥⌘P opens the pocket's list, where the arrow keys pick a window and Return takes it out.
    • New: Maximize Height (⌃⌥⇧M) and Maximize Width (⌃⌥⌘M) fill one side of the screen and keep a share of the other, sized for each screen's shape. The new Maximize card in Layout Defaults lists your screens by shape (Laptop, Widescreen, Ultrawide, Super Ultrawide, Portrait) and sets each shape's share, from ¼ to ¾ or your own with Custom…, and whether the window grows from the centre or from where it is.
    • New: Swap here in KiwiHub's window switcher. ⌥↩︎ or ⌥-click brings the window you picked into your window's spot and sends yours to where it was.
    • New: Step between Spaces (mouse or trackpad) in Looks & Animations ▸ Animations picks the scroll step's own transition, so a scroll can slide while keys switch at once.

    Improved

    • The pocket now has its own Show — Always, Auto or Hidden — under KiwiShelf ▸ Show ▸ Each bar and Pocket, and holds any number of windows. The Holds row in Shortcuts & Gestures ▸ Pocket is gone, and your choice there carries over on its own.
    • Clicking an empty pocket now explains it, with its keys and a way to Pocket Shortcuts….
    • Growing a window in a Stack, Track or Grid row no longer stops at its neighbour's minimum: the neighbour joins the windows waiting behind the +n mark, and shrinking brings it back.
    • Resizing a layout or flipping its stack side now changes only the macOS Desktop you're on, so the same Space on your other Desktops keeps its own sizes.
    • Tile Window now works on a window an app rule floats, and keeps it tiled until it closes; the app's next window floats by the rule again.
    • Maximize now works on a sticky window, and ends when you leave that Space.
    • When a neighbouring window at its minimum blocks a resize, the message now names that window's app.
    • Resizing a floating video window, such as mpv or QuickTime Player, from the keyboard now keeps its shape.
    • KiwiHub's lists now wrap round on a fresh press, and KiwiHub now lists windows that were already full screen when KiwiDesk started. Holding a key still stops at the end.
    • The bars' right-click menus now show the shortcut for Float Window, Tile Window and Remove from Pocket.
    • Settings' dark mode is now black and deep green, Home's cards keep their dark green in light mode, and every clickable tile and card now lifts under the pointer, with a grey edge of its own that a selected tile's green never shares. In light mode, every desk picture outside Home sits on the light plate, whatever the look.
    • Simple's Look line now leads with all of My looks, each with Rename… and Delete, and Settings' sideways rows now show their scroll bar below the tiles instead of hiding it.
    • Shortcuts & Gestures now opens faster, and hovering a look on Simple no longer stutters.
    • Restore… for your shortcuts now sits in a Default shortcuts row under Layers, beside Import from init.lua…, and says why when it's greyed; a line now sets off the shortcuts that belong to the picked layer.
    • A refusal's message now wraps onto more lines instead of being cut off on a narrow window, and stays a little longer to be read; Tile Window's starts with "Can't tile."
    • The docs are reworked, with pictures where words fell short: Spaces & Desktops now shows how screens, macOS Desktops and Spaces fit together, a Desktop's Spaces across a disconnect, and Displays have separate Spaces on and off; the Lua reference draws the seven layouts, gaps, BSP and scrolling. Every diagram follows KiwiDesk's colours in light and dark.

    Fixed

    • KiwiDesk no longer quits when a BSP layout splits a space its windows' minimum sizes fill exactly, as could happen when cycling into BSP or resizing a window. Thanks to @MDsza for the report and the fix.
    • The arrows beside a number field in Settings now update the number you see while the field is selected, not only the value it saves.
    • A shortcut, its clear button and its bin now line up in Pocket and Open applications even when Settings opens in a narrow window.
    • Swiping fast between two macOS Desktops that show the same Space no longer scrambles its layout, and a restart keeps the windows on your other Desktop in their places.
    • Entering or leaving full screen now keeps a window's place, a window left in full screen is no longer forgotten, and Jump now shows the full-screen window you picked.
    • Un-maximizing a window near a screen's bottom or right edge no longer leaves it too large.
    • In a Scrolling layout, going round the row no longer leaves the windows on screen stacked in the wrong order.
    • A floating window that won't take a size, such as Calculator, no longer walks sideways or shows a false "No room left to grow", and holding a resize key now stops quietly at the limit.
    • Maximize no longer turns KiwiVision's dimming off on that screen.
    • VoiceOver can now reach every window in the pocket's list.

    Lua & CLI

    • If a script reads KiwiDesk's replies or events: list_windows' floats is now effective_float; app_rule.list returns app_rules, float_rules, tile_rules and ignore_rules; space_change and layout_change send mode for layout_mode; list_monitors nests its frame under frame; and explain_app's windows and minimized are now objects with id and title. The old names are not kept.
    • If you write your own Lua config: pocket.set_capacity is retired and kiwishelf.set_pocket_visibility sets the pocket's Show; saved settings move over on their own, and the old name is refused, naming its replacement.
    • New verbs: toggle_maximized takes "height" or "width", with maximize.set_share and maximize.set_anchor for the defaults, each for one screen shape or all five; pocket_app gives an app its Pocket key; pocket.toggle_list opens the pocket's list; center_floating and move_floating centre and nudge the focused floating window; and set_space_scroll_transition picks the scroll step's transition.
    • move_to_desktop and move_to_desktop_and_follow now take a window id and reach a window on a hidden Desktop, and with Displays have separate Spaces off they cross screens and Desktops in one move.
    • list_windows and explain_window now return each window's title, and window_created reports existing for a window found at start or found again.
    • A refusal now says which rule stopped the command rather than repeating your arguments, and a failed Lua call logs its arguments instead.
    • kiwidesk subscribe and the other socket commands now end cleanly when the other side closes, and kiwidesk set_min_window_size now reads its height.
    • Install KiwiDesk with Nix and Home Manager from the KiwiCanopy/nix flake. That copy updates with home-manager switch, and Settings says so.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v4.1.0...v4.2.0

  6. 4.1.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 4.1.0 is all about looks: find one in the new gallery, share your own, and wear it from the new Simple page in Settings.

    Spotlight

    • Find your look — Browse the new looks gallery and add a look in one click. {setting:(action) look.browse} {symbol:photo.on.rectangle.angled}
    • Show off yours — Share current look… sends your look to the gallery, credit included. {setting:(action) look.share} {symbol:paintpalette}
    • A new way in — The old front door to Settings had to go; I rebuilt it as one page for your look, your Spaces and your apps. {symbol:gearshape}
    • Your look, your call — Each profile wears the shared look or keeps its own. {setting:(action) look.applies_to} {symbol:rectangle.on.rectangle}
    • Room for more in your pocket — The pocket now holds several windows; drag one onto it. {setting:appWide.pocketCapacity} {symbol:tray.full}

    New

    • New: a looks gallery on the KiwiDesk website, where people share their looks. Click Add to KiwiDesk on one and Settings opens wearing it, unsaved until you Save, with its author named on its tile; Browse looks… in Looks & Animations ▸ My looks, and the tile at the end of Simple's Look line, take you there.
    • New: Share current look… in Looks & Animations ▸ My looks opens the gallery's submission form in your browser with your look filled in, and credits the look yours started from while you've kept at least half of it.
    • New: Settings now opens on a Simple page with your KiwiHub keys, your looks, your Spaces as cards you can rename, reorder and give a layout, and the apps you open by key; hovering a look previews it on every Space card. A look added from the gallery leads its Look line, and right-click deletes it.
    • New: the pocket can now hold several windows. Set Holds to Several windows in Shortcuts & Gestures ▸ Pocket and the pocket stays on screen, listing what's inside when you click it; under either setting, dragging a window onto the pocket puts it away, and the bars' window menus now offer Pocket Window.

    Improved

    • Each profile's Looks & Animations page now asks one thing, Look: Shared or This profile only, and names the profiles also wearing the shared look; switching to Shared asks whether to use the shared look or make this one the shared look, and offers to save yours to My looks first.
    • A look's tile now shows a small desk drawn in that look: its bars, font, colours, gaps and focus ring.
    • In light mode, the pictures of your desk in Settings now sit on a light plate, from Simple's Space cards to Advanced's layout sketches; a look whose colours need a dark background keeps the dark one.
    • The pocket now belongs to KiwiShelf: it slides out of your bar's edge as a window goes in or out, without moving the bar, and Pocket edge and Pocket position have moved to the KiwiShelf page.
    • The sticky, floating and pocket marks on a window are now frosted glass, and their colour paints the symbol; a Space Bar icon holding a pocket window and a floating one now shows both badges.
    • Dragging a window onto another now shows an untinted frosted drop zone, and pushing the drag against an Auto Space Bar's edge opens it so you can drop the window on a Space. The drop zone's and the ghost's colour, fill and border settings are gone; Gaps & Borders ▸ Drag & drop keeps Show drop zone and Mark where the window came from.
    • KiwiHub and the Desktop switch now number macOS Desktops per screen, as Mission Control does, and KiwiHub names the screen a window is on when it isn't the one KiwiHub opened on.
    • Restore… now asks with one Restore button and an Include init.lua box that starts off, so a backup's init.lua replaces yours only when you tick it.
    • Text on KiwiHub, the hover labels and the Space plates now stays easier to read where the Fill fades, a hovered KiwiHub layout tile included, and Colors & glass now points to macOS's own Liquid Glass slider, which sets how see-through the glass is.

    Fixed

    • Windows in a Stack that fit side by side no longer overlap after a relaunch or a Settings Save.
    • A window KiwiDesk hides in a screen's bottom-left corner no longer leaves a strip showing.
    • KiwiHub's Move here now brings the window to the screen KiwiHub opened on, from another screen's macOS Desktop too, and holding ⇧ shows the way here on the row under the pointer.
    • Moving a window to the Space it's already in now leaves it where it is and says so, instead of sending it to the end of the row.
    • Typing in Settings ▸ Shortcuts & Gestures no longer lags, and the Lua editor's cursor no longer jumps while you type.
    • On a Space switch's slide, a floating window no longer takes the app icons off the tiles it overlaps.
    • Taking a window out of the pocket no longer leaves a blank moment before it appears.
    • Settings no longer draws Safari's icon with an alias arrow.

    Lua & CLI

    • If you write your own Lua config: pocket.set_edge and pocket.set_position are now kiwishelf.set_pocket_edge and kiwishelf.set_pocket_position, and the drag. verbs for the markers' colour, fill, border and alignment are retired, since their look is fixed. Saved configs move over on their own, and each old name is refused, naming its replacement or why it went.
    • New verbs: get_settings reads the live settings back, whole or one value, as a Space uses them; stack.toggle_stack_position moves a Space's stack zone to the other side; pocket.set_capacity sets how many windows the pocket holds; kiwishelf.set_reading_contrast sets how much contrast text keeps where the Fill fades; and pocket takes a window id.
    • From the command line: kiwidesk preview <look file> <image> draws a look file's picture without the app running.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v4.0.0...v4.1.0

  7. 4.0.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    For KiwiDesk 4.0.0 I've reworked every layout so your windows always fit — plus a Pocket, a Maximize key and many other things to discover.

    Spotlight

    • Bye-bye, window piles — Windows that don't fit now scroll into view instead of piling up. {symbol:figure.wave}
    • Put it in your pocket — ⌃⌥P tucks a window away and brings it back on any Space. {setting:keybinding.pocket} {symbol:tray.and.arrow.down.fill}
    • Maximize for a moment — ⌃⌥M gives one window the whole screen; press again to put it back. {setting:keybinding.maximize} {symbol:arrow.up.left.and.arrow.down.right}
    • The Space slide is back — You asked, I listened: it's back, and you choose how it looks. {setting:appWide.spaceTransition} {symbol:arrow.left.arrow.right}
    • True Liquid Glass — Your KiwiShelf Fill now tints the glass itself, fading from the edge. {setting:settings.kiwishelf.fillFade} {symbol:drop}
    • Focus crosses screens — Past the last window, focus moves on to your next screen. {setting:config.focusWrap} {symbol:display.2}

    New

    • New: windows now always fit, in every layout. KiwiDesk learns each app's own minimum size and keeps it, and where windows no longer fit, Stack, Track, Grid and BSP scroll the rest in from off screen as you move focus instead of piling them up; a "+n" mark on the edge window counts what's hidden, and clicking it lists them.
    • New: Pocket keeps one window one key away. ⌃⌥P tucks it off screen and brings it out floating over whatever you're on, and ⌃⌥⇧P (Toggle Pocket) picks which window it is; a brief pocket on screen shows it going in and out, and Shortcuts & Gestures ▸ Pocket sets where.
    • New: ⌃⌥M maximizes the focused window to fill its screen with the bars out of the way, without a macOS full-screen Desktop; press it again, or move focus to another window, to put it back.
    • New: with Liquid Glass on, the KiwiShelf Fill now tints the glass itself and fades from the screen edge, and KiwiHub and the Space plates wear it too; Fill fade and Tint KiwiHub and plates in Looks & Animations ▸ Colors & glass change both, and emptying the Fill's colour field gives clear glass.
    • New: Go to last screen takes you back to the screen you were on before.
    • New: shortcuts can now tell left and right modifiers apart. Turn on Tell left and right modifiers apart under Shortcuts & Gestures ▸ Modifier keys, which is the Hyper key card's new name.
    • New: your own Lua shortcuts can now carry a description, a shortcut group and a symbol, edited in Shortcuts & Gestures ▸ Lua bindings, and KiwiHub lists them that way, naming shortcuts built in a loop by what they do.

    Improved

    • A Grid's Columns and Rows are now a Column limit and a Row limit: the grid lays out only as many as fit its largest window's minimum size, and grows back when that window closes.
    • Space switches now slide again, and Looks & Animations ▸ Animations ▸ Space switches picks Slide, Show the Space or None; if you had turned off showing the Space after a switch, they stay instant.
    • A window you float or tile now glides to its new place and size instead of jumping; Animate float, Pocket & maximize in Looks & Animations ▸ Animations turns it off.
    • Moving focus past the last window now carries on to the next screen, and Next and Previous Space wrap round. Every profile starts on All screens; Shortcuts & Gestures ▸ Focus ▸ Wrap focus sets This screen or Off.
    • When a shortcut moves focus to another screen, the pointer now goes with it, unless it's already on that screen.
    • A new window an App Rule sends to a Space you can't see now takes you there, as opening the app already did.
    • Moving focus toward several windows at once now goes back to the one you came from instead of picking the middle one.
    • Settings no longer has Simple and Power User modes: everything is on one surface, Layers and Modifier keys are cards in Shortcuts & Gestures, macOS Desktop shortcuts have a section of their own, every Space row has a Customize button, and Home shows Screens on one screen too.
    • A bar's window list now opens when you click its item, and hovering only shows its label; clicking a glyph with several windows no longer cycles through them.

    Fixed

    • Stepping focus through a Scrolling row no longer lags about a second when a slow app is in it.
    • A window that floats on its own, moves after a screen change or is put back after waking now waits until you stop moving the mouse, so it no longer jumps under a click.
    • Brave's main window no longer shrinks and centres while a site's permission prompt is open.
    • Windows no longer leave their Spaces after a long screen lock: while your Mac is locked, KiwiDesk keeps every window where it was.
    • Archive Utility's unzip progress window no longer takes a tile.
    • ⌘S in Settings now saves the value you're still typing, and closing or quitting asks about it.
    • A shortcut whose Lua has an error no longer does nothing silently: Settings warns on its row and lists it as a Config Issue.
    • App Bar items no longer change width when a window's title changes.
    • On a Boxed KiwiShelf, a hiding bar's Grow reveal now animates, and a highlighted box no longer shows a thin white line under Liquid Glass.

    Lua & CLI

    • If you write your own Lua config: scroll.set_wrap_focus, monocle.set_wrap_focus and track.set_wrap_focus are now set_focus_wrap; set_space_cue is now set_space_transition and animations.set_space_change_duration is now set_space_slide_duration; stack.set_overflow_style, track.set_overflow_style and their _override verbs are retired, since a full zone now scrolls. Saved configs move over on their own, and each old name is refused, naming its replacement or why it went.
    • New verbs for this release's features: pocket, toggle_pocket_window, pocket.set_color, pocket.set_edge, pocket.set_position, toggle_maximized, focus_display_last, focus_display <direction>, set_space_transition, set_space_slide_duration, set_focus_wrap, set_modifier_sides with lcmd/rcmd-style sided modifiers, animations.set_on_state_change, animations.set_on_peek, kiwishelf.set_fill_fade, kiwishelf.set_tint_hub_and_plates and kiwihub.set_key; KiwiDesk.bind takes desc, group and symbol.
    • From the command line: export_setup and restore_setup back up and restore a setup, list_windows now gives each window's stacking order, list_commands --kind lists actions, settings or queries, and get_config_status names a shortcut that cannot run.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v3.2.0...v4.0.0

  8. 3.2.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 3.2.0 lets each bar hide until you need it, keeps your setup the same on every Mac, and lets one layout or Space tile smaller windows than the rest.

    Spotlight

    • Bars that hide until you need them — Set each bar to Always, Auto or Hidden; ⌃⌥G and ⌃⌥H show a hiding one. {setting:settings.spaceBarStyle.visibility (master)} {symbol:menubar.arrow.up.rectangle}
    • KiwiVision fades in — The window you leave now eases into the dim; choose how fast. {setting:appWide.visionFadeDuration} {symbol:binoculars}
    • The App Bar shows what's on your screen — Windows you can see are lit; ones cut off or covered are dimmed. {symbol:eye}
    • Your setup on every Mac — Keep KiwiDesk in step through iCloud Drive or a folder you pick. {setting:UserDefaults.general.syncFolder} {symbol:icloud}
    • Smaller tiles where you want them — Give a layout, or a single Space, its own minimum width × height. {setting:settings.minWindowSizes (master)} {symbol:ruler}
    • Take back one change at a time — Every unsaved change in Settings now has its own ↺ to undo it. {symbol:list.bullet.rectangle}

    New

    • New: each bar can now hide until you reach for it. KiwiShelf ▸ Show sets the Space Bar and the App Bar to Always, Auto (a thin mark that opens when the pointer rests on it) or Hidden, which ⌃⌥G and ⌃⌥H show over your windows. A hiding bar slides in from the screen edge, or grows, unfolds or fades in as KiwiShelf ▸ Reveal picks, with its timing under KiwiShelf ▸ Durations. Your bars stay as they were, and updating adds the two keys where they're free; change them in Shortcuts & Gestures ▸ Show & hide.
    • New: keep your setup the same on every Mac. General ▸ Sync across Macs picks iCloud Drive or a folder: Compare and Copy… shows both sides before you keep one, and Keep in sync automatically copies each change across, asking you only when both Macs changed the same setting.
    • New: windows can now tile smaller in one layout or Space than in the rest. Layout Defaults ▸ Minimum window size takes a width and a height, for every layout at once or each apart, and Spaces ▸ Customize… gives one Space its own; your current size carries over to every layout.
    • New: the App Bar now shows which windows you can see. A window fully on screen is lit, one cut off by the screen's edge or covered by another is dimmed, and in Scrolling a cut-off column is marked on the side that still shows.
    • New: resting the pointer on a Space the Space Bar shows as a count now lists its windows; click one to go straight to it.
    • New: with KiwiVision on, the window you leave now fades into the dim instead of dimming at once. Fade duration and Fade curve are under KiwiVision ▸ Dim and blur, and a duration of 0 makes it instant again.
    • New: Settings can now take back one change at a time. Every unsaved change has its own ↺, a shortcut you moved goes back together with the one it displaced, and Revert now also undoes changes made by a shortcut, the command line or an AI app.

    Improved

    • Grid columns and rows can now be resized with the size keys and by dragging the edge between two windows, like every other tiled layout.
    • Moving focus past the last window now wraps to the first in Scrolling, Monocle and Track for a new setup or an init.lua that doesn't set it; a profile you've saved keeps what it had, and Layout Defaults ▸ Wrap focus changes it.
    • Switching between busy macOS Desktops is now quicker: the focus border, the bars and your shortcuts no longer wait while KiwiDesk looks over the windows that arrived.
    • The Hyper key card now has one Shortcuts use: ⌃⌥ | ✦ switch that moves every KiwiDesk shortcut onto Hyper, or back, in place of the one-time offer. When a key remap another app left behind keeps Hyper off, the card now names it, and offers Take Over… when it's the same remap KiwiDesk would set.
    • KiwiHub's shortcuts side (⌃⌥K) now lists the shortcuts your init.lua binds, instead of only saying that init.lua manages them.
    • The bars now animate with Reduce Motion on, as the Dock does: a hiding bar still slides in and the bars still expand and move into place, while windows keep moving without animation; the Animations card now says when Reduce Motion is the reason it's greyed.
    • Every colour now lives in Looks & Animations ▸ Colors & glass, which replaces the Advanced Colors page, and the KiwiHub, KiwiShelf and KiwiVision keys now share one Show & hide card at the top of Shortcuts & Gestures.

    Fixed

    • With Reduce Motion on, windows now land at once and at their full size: a Stack reflows right after you open or close a window, and a window moved to another screen no longer keeps a wrong size.
    • With the Dock set to hide, clicking it again no longer moves KiwiDesk's focus to the Dock's screen while the app you picked stays in front on another.
    • A browser extension's popup, like Bitwarden's, no longer closes as it opens when the browser's App Rule points at a Space that isn't showing.
    • With a Hyper key set but no shortcut using it, pressing the key no longer beeps; KiwiDesk now says that no shortcut uses Hyper.
    • Switching from a Space with an App Bar to one without no longer leaves a dark strip past the Space Bar.
    • Clicking beside a bar that doesn't fill its edge now reaches the window under it instead of landing on the bar's empty strip.
    • The App Bar's floating mark now stays visible on a Boxed bar over light windows: it draws in full ink with a soft edge, and the gap before it marks the break.
    • NoMachine's empty second window no longer takes a tile of its own beside the real one.

    Lua & CLI

    • If you write your own Lua config: space_bar.set_enabled is now space_bar.set_visibility, and monocle.set_app_bar_enabled and scroll.set_app_bar_enabled are now set_app_bar_visibility, each taking always, auto or hidden; animations.set_shelf_duration and animations.set_on_shelf are now animations.set_expand_duration and animations.set_on_expand, and saved configs move over on their own; each old name is refused with its replacement. set_min_window_size now takes a width, an optional height and an optional layout, and a single number still works.
    • New: list_windows gives every window's frame, screen and whether it's in view, and focus_window <id> focuses one by id, switching Space if it has to; list_monitors now gives each screen's position and the area its Space lays windows out in.
    • New: swap now takes window ids: swap <id> trades the focused window with any window, on another Space or screen too, swap <id> <id> trades two windows, swap <dir> <id> swaps a named window with its neighbour, and swap_here <id> brings a window into your slot.
    • New verbs for this release's settings: space_bar.toggle_reveal, app_bar.toggle_reveal, kiwishelf.set_reveal_style (slide, grow, unfold or fade), kiwishelf.set_reveal_timeout, animations.set_reveal_duration, set_min_window_size_override, grid.set_column_weight, grid.set_row_weight, kiwivision.set_fade_duration and kiwivision.set_fade_curve. From the command line, revert_settings takes back unsaved live changes, take_over_hyper_remap adopts a matching leftover remap, and get_config_status reports Config Issues and the sync status, which kiwidesk mcp now reads to say why a change can't be kept.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v3.1.0...v3.2.0

  9. 3.1.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 3.1.0 adds one key to put a Space's window sizes back, and Settings now records Hyper shortcuts.

    Spotlight

    • Window sizes back in one key — Resized for a moment? ⌃⌥R returns the Space to your profile's sizes. {setting:keybinding.reset_sizes} {symbol:rectangle.split.3x1}

    New

    • New: ⌃⌥R puts back the sizes in the Space you're on — every window you resized there, by key or by dragging, returns to what your profile set. Updating adds the key where it's free and the action has no shortcut yet, as ✦R if you moved your letter shortcuts to Hyper; change or remove it in Shortcuts & Gestures ▸ Size & float.

    Improved

    • Switching to a Desktop that loads its own profile is now quicker, without the brief stall it could have on the way in.

    Fixed

    • With a Hyper key set, Settings now records Hyper shortcuts too: they already worked from init.lua and the CLI, but recording one in Settings kept only the key. Now holding the Hyper key adds ✦.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v3.0.0...v3.1.0

  10. 3.0.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 3.0.0 brings KiwiVision for focus, KiwiHub for windows and shortcuts, a layout cycle, and setup by asking your AI app.

    Before you update: Space switches no longer slide — they're instant, and a screen without a Space Bar names the Space for a moment. The menu bar's Layout, Switch Profile and View Shortcuts… rows are now one Open KiwiHub… row.

    Spotlight

    • Everything but your focus fades back — ⌃⌥V dims everything else; a lens keeps the apps you pick clear. {setting:appWide.visionLenses} {symbol:binoculars}
    • One panel for windows, shortcuts and layouts — ⌃⌥J finds a window, ⌃⌥K your shortcuts, ⌃⌥L a layout, profile or lens. {setting:keybinding.show_shortcuts} {symbol:macwindow}
    • Step through your layouts — ⌃⌥C moves the Space you're on to its next layout, ⌃⌥⇧C back. {setting:config.modeCycle} {symbol:rectangle.3.group}
    • Set KiwiDesk up by asking your AI app — Add it to Claude Desktop in a click; other AI apps get a setup prompt. {setting:(action) ai.setup.desktop} {symbol:brain.head.profile}
    • Hold one key instead of several — Make Caps Lock or another key Hyper; move ⌃⌥ letter shortcuts to it. {setting:appWide.hyperKey} {symbol:capslock}
    • Focus follows the pointer — Rest the pointer on a window to focus it; off until you turn it on. {setting:settings.mouse.hoverFocus} {symbol:cursorarrow}

    New

    • New: KiwiVision (⌃⌥V) dims and blurs everything but the window you're in. Settings ▸ KiwiVision sets how much, whether the wallpaper or the current app's other windows stay clear, which apps are never dimmed, and whether macOS switches to Dark while it's on.
    • New: KiwiVision lenses keep the apps you pick clear, each on its own shortcut and in the profiles you choose; while one is on, KiwiDesk's focus keys stay on those apps. Make one with New Lens… in Settings ▸ KiwiVision.
    • New: KiwiHub, one panel on ⌃⌥J, ⌃⌥K and ⌃⌥L. Jump to any window by typing its name (⇧↩︎ brings it to the Space you're on), see every shortcut, or pick a layout, profile or lens for the Space under the pointer; Tab steps between the three.
    • New: ⌃⌥C switches the Space you're on to its next layout and ⌃⌥⇧C to the previous one, with a moment's picture of the cycle. Choose the layouts it walks under Shortcuts & Gestures ▸ Layout ▸ Layouts to cycle; it starts with BSP, Scrolling and Floating.
    • New: set KiwiDesk up by asking your AI app. Settings ▸ AI adds KiwiDesk to Claude Desktop in one click or copies a setup prompt for Claude Code, Cursor or Codex, with ready-made prompts for your Spaces, a new look, app rules or a move from another window manager; setting changes stay temporary until you say keep.
    • New: focus can follow the mouse — rest the pointer on a window and it takes the focus. Off by default; turn it on under Shortcuts & Gestures ▸ Mouse & trackpad ▸ Focus and the pointer.
    • New: a Hyper key. Shortcuts & Gestures ▸ Hyper key turns Caps Lock, a modifier (left and right apart) or an F-key into an extra modifier no app uses, without Input Monitoring, and offers to move your ⌃⌥ letter shortcuts and Go to Desktop keys onto it. Quitting KiwiDesk gives the key back.
    • New: a What's new link in Settings Home's footer opens the notes of any release since 2.0.0.

    Improved

    • Space switches are now instant and no longer slide; on a screen without a Space Bar a plate names the Space you arrived on for a moment. Turn it off under KiwiShelf ▸ Show ▸ Show the Space after a switch.
    • A Monocle Space no longer flips a card when focus moves: the next window comes straight to the front, and the two flip settings are gone.
    • The menu-bar menu now has one Open KiwiHub… row in place of Layout, Switch Profile and View Shortcuts…; it opens KiwiHub on its Layout, Profile and KiwiVision lines.
    • Updating now adds ⌃⌥J, ⌃⌥L, ⌃⌥C, ⌃⌥⇧C and ⌃⌥V wherever the key is free and the action has no shortcut yet; change or remove them in Shortcuts & Gestures. ⌃⌥K still opens your shortcuts, now as KiwiHub's middle side.
    • Scrolling and Monocle have new symbols in the Layout menu, the Space Bar and KiwiHub, so the two no longer look alike.
    • A look now carries your animations too, so changing them on the shared look reaches every profile that wears it.
    • Settings looks and responds more consistently: every button, palette, chip and menu lifts grey under the pointer, searchable lists move one kiwi highlight with both the pointer and the keys, and the font and app pickers match macOS's own pop-ups.
    • Settings now lists changes made from outside it, by a shortcut, the command line or an AI app, under Live, not saved in the save pill, and Save no longer puts back a change made while Settings was open; Keep saves them into your profile.

    Fixed

    • An app that takes a few seconds to start, like Word, Xcode or VS Code, now takes you along to its App Rule's Space.
    • Floating windows now stay above the tiles after a Space Bar or App Bar click or a keyboard focus move, and the focus border no longer slips under a floating window or goes missing on a floating sticky one.
    • With the menu bar shown on hover, the window you were in no longer flickers while the pointer rests at the top of the screen on macOS 27.0.1.
    • A shortcut on ⌃1 to ⌃9 now warns that macOS's Switch to Desktop shortcut takes that key.

    Lua & CLI

    • If you write your own Lua config: show_shortcuts is now kiwihub.show("shortcuts"), the slide's animations.set_on_space_change, animations.set_space_change_duration and set_space_switch_liquid_glass give way to set_space_cue, and animations.set_on_monocle_focus and animations.set_monocle_flip_duration are gone. Each old name is refused with its replacement, and shortcuts saved in Settings are renamed for you.
    • New verbs: kiwivision.*, look.*, app_rule.*, shortcut.*, explain_window and explain_app, move_here, set_hyper_key, mouse.set_hover_focus and mouse.set_hover_focus_delay; kiwidesk mcp serves them to AI apps.
    • kiwidesk completion zsh|bash|fish and kiwidesk watch are new, subscribe --reconnect survives a relaunch, and an app verb given an app's name now suggests its bundle id.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v2.3.1...v3.0.0

  11. 2.3.1

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 2.3.1 leaves Spotlight alone on macOS 27.

    Fixed

    • Spotlight stays where it opens on macOS 27 — KiwiDesk mistook Spotlight's search panel for one of your windows: typing nudged it down, and sometimes it opened in a corner of the screen. KiwiDesk now leaves it alone.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v2.3.0...v2.3.1

  12. 2.3.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 2.3.0 puts windows back after a restart, adds keys for moving between Spaces, and floats Settings windows on its own.

    Spotlight

    • Back where they were after a restart — When your Mac restarts and macOS reopens your apps, each window goes back to the Space it was in. {symbol:desktopcomputer}
    • Keys for moving between Spaces — ⌃⌥⌘← and → step to the previous or next Space; ⌥⌘Tab jumps back to the Space you were just on, like a browser's Back button. Updated from an earlier version? Restore Defaults… in Shortcuts & Gestures brings the arrows. {setting:config.spaceHistory} {symbol:keyboard}
    • Each screen can put its bars on its own edge — With two screens, the Space Bar can sit at the top of one and at the bottom of the other. {setting:settings.spaceBarStyle.edgeOverride[screen]} {symbol:display.2}
    • Settings windows float on their own — Windows that can't be resized, like an app's Settings or Calculator, now float instead of being squeezed into a tile. If one floats that you'd rather tile, add its app under App Rules ▸ Tile. {setting:config.tileRules} {symbol:macwindow.on.rectangle}

    New

    • After a restart of the Mac or a logout, your windows now go back to the Spaces they were in, and the notice under the menu-bar icon counts them back in.
    • New keys for moving between Spaces: ⌃⌥⌘← / → step to the previous or next Space, and ⌥⌘Tab / ⌥⌘⇧Tab go back and forward through the Spaces you visited, like a browser. An updated setup gets ⌥⌘Tab / ⌥⌘⇧Tab added; the arrows keep your swap until you restore the defaults (see below).
    • Each screen can now put its bars on its own edge — the Space Bar at the top of one screen and the bottom of another, say — under KiwiShelf ▸ Each bar ▸ Per screen.
    • A Desktop switch KiwiDesk makes now shows the Desktop's number for a moment; turn it off under Profiles ▸ Profiles per macOS Desktop.
    • An app's shortcut can now bring all of that app's windows into the Space you're on: pick Gather Windows as its action.
    • KiwiDesk now warns once when AeroSpace, Amethyst or OmniWM runs beside it, and can quit it for you.

    Improved

    • Some default shortcuts now sit on better keys: swap is now ⌃⌥⇧ + arrows, freeing ⌃⌥⌘ + arrows for the previous and next Space. Your keys stay as they are; to take the new ones, click Restore Defaults… in Shortcuts & Gestures. It resets only the Default layer, keeps shortcuts you made yourself unless they use one of those keys, and shows what it changes before you confirm.
    • New default shortcuts now reach your setup when you update: from this release on, each one is added where its key is free and you have no shortcut for that action yet. Nothing you set is changed, and one you remove isn't added back.
    • Windows that can't be resized, like many apps' Settings windows or Calculator, now float on their own instead of being squeezed into a tile. If one floats that you'd rather tile, add its app under App Rules ▸ Tile; App Rules ▸ Automatic floating turns the guess off altogether.
    • ⌃⌥⇧⌘ + a number now goes to that macOS Desktop, added for each Desktop whose shortcut is free; one you remove isn't added back.
    • Quitting KiwiDesk now gathers floating windows too, and the next launch puts each one back where it floated.
    • Unsaved Settings edits no longer wait in a closed window: closing Settings or quitting now asks whether to save them, and open dialogs close instead of holding up a quit.
    • A Space can now have its own gaps, set in its Customize… overrides on the Spaces page.
    • Advanced Colours now groups colours by what they colour, so one pick can recolour a whole group at once.
    • The Monitors page is now called Screens, and KiwiDesk calls a physical screen a screen in every language; searching for "monitor" still finds it.
    • An empty temporary Space you visit and leave now goes away, and temporary Spaces sort by number.

    Fixed

    • A window you close with ⌘W or open with ⌘N is now arranged at once instead of waiting for the mouse to rest.
    • Switching macOS Desktops no longer freezes a busy desk for a moment, and the focus border slides away with its window.
    • Coming back to a Desktop now focuses the sticky window that followed you, and switching profiles away and back keeps every window in its Space.
    • Overlays that cover the whole screen, like Slack's huddle drawing or a dictation HUD, are now left alone.
    • Ghostty's configuration-error and update windows, and titled windows of menu-bar apps, now float instead of being ignored.
    • A floating window that fills the screen no longer hides the bars as if it were a slide show, and the focus border now fits a floating window that keeps its own size.
    • App Bar boxes no longer leave faint trails as they slide with the Liquid Glass look, and pop-up notices no longer clip their ends.
    • Settings no longer saves over an init.lua you changed in another editor, and it now says when a first Save moves your shortcuts and rules into the visual editor.
    • A new laptop profile's Grid now holds four windows, two by two, instead of piling the third onto the second.
    • Open at Login no longer registers a copy that can't start at login, such as one run straight from a download.
    • The detached preview card in Settings no longer judders while you drag it.

    Lua & CLI

    • space_bar.set_reserve and app_bar.set_reserve are new: with reserve off, a bar draws over the windows instead of making room, so showing or hiding it moves no window.
    • kiwidesk self_test is new, and reports which of the private macOS calls KiwiDesk relies on this macOS still answers.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v2.2.0...v2.3.0

  13. 2.2.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 2.2.0 is about speed: Spaces, focus and startup no longer wait on a slow app, and Space switches now slide past in a snappy 300 ms.

    Spotlight

    • Keeps up under load — A Space switch now makes a third of the accessibility calls it did in 2.1.1. {symbol:gauge.with.dots.needle.67percent}
    • Space switches slide — The Space you leave and the one you pick glide past on plates with each app's icon, in 300 ms. {setting:settings.animations.onSpaceChange} {symbol:rectangle.on.rectangle}
    • Windows on hover — Rest the pointer on an app in the bars to list its windows, then click one to go there. {symbol:list.bullet.rectangle}
    • Layers per profile — Choose which profiles a keyboard layer belongs to. {setting:config.layers[].reach} {symbol:keyboard}

    New

    • Space switches now slide: the Space you leave and the one you pick glide past together on plates showing each app's icon, on by default at 300 ms, also in profiles saved before 2.2.0, since the old setting moved the windows themselves. KiwiDesk comes opinionated, but it's yours: turn it off or set its pace under Looks & Animations ▸ Animate Space switches. Reduce Motion keeps the switch instant.
    • Rest the pointer on an app in the bars for a list of its windows, the focused one checked; click a row to go straight to it.
    • A keyboard layer can now choose which profiles it belongs to, under Applies to in Shortcuts & Gestures.
    • Shortcuts & Gestures now opens with a row of jump chips that take you straight to a group.
    • A slow start now shows a quiet notice under the menu-bar icon until your windows are in place.

    Improved

    • Switching Spaces, moving focus and starting up no longer wait on a slow app, like System Settings or a busy GPU, and a new app's first window tiles right away. A Space switch now makes about a third of the accessibility calls 2.1.1 made and moves a quarter of the windows; the performance page has the numbers.
    • KiwiDesk no longer rearranges windows under your hand: a window opening or closing while you drag waits until you rest.
    • Focus shortcuts pressed quickly in a row now keep going instead of stopping while the previous app comes forward.
    • A click on a Space Bar icon that stands for several windows now steps through them, and on another Space's icon goes there.
    • The Space Bar's front app now keeps one length, so nothing beside it shifts as focus moves, and it grows in and out as it comes and goes.
    • Right-click menus in the bars now name the app at the top, and the Space Bar's front app offers its window's actions too.
    • A floating window dropped past the bottom of the screen now shrinks to fit instead of hanging off it.
    • Settings now reads more clearly in Dark Mode, and a few names changed: KiwiShelf & Bars is now KiwiShelf, and the motion rows are Window duration and KiwiShelf duration.
    • Before an update changes a settings file, KiwiDesk now keeps a copy in ~/.config/KiwiDesk/migration-backups.
    • Granting Accessibility no longer rearranges your windows by itself: a new setup starts tiling when you press Start Tiling.

    Fixed

    • The focus border no longer stays over Mission Control on macOS 27 or sits on a slide show, and after a Space switch it arrives with its window.
    • On a Scrolling Space, a window no longer jumps back and slides in again right after a Space switch.
    • Going to a Space that doesn't exist yet now shows it on the Space Bar instead of an empty desk.
    • Closing a window no longer sometimes takes you to the same app's window on another Space.
    • KiwiDesk started while the screen is locked now picks up your windows after you unlock.
    • The right-most items of a scrolled App Bar now take clicks.
    • A floating window flicked up under the menu bar or the shelf now comes back out.
    • Deleting a keyboard layer now removes the shortcuts that switch to it.
    • Opening Settings while it's open now keeps your page.
    • The welcome tour's Looks step is now translated into every language KiwiDesk speaks.

    Lua & CLI

    • If you write your own Lua config: pull_or_spawn is now focus_or_spawn, the name for what it always did. Shortcuts you made in Settings are updated for you; a call in your own init.lua now fails and names focus_or_spawn.
    • animations.set_on_space_change now defaults to on, and the new animations.set_space_change_duration sets the slide's pace, 300 ms unless you set it. A config that calls the setter keeps its value.
  14. 2.1.1

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    A small cleanup this time: a few quick findings I fixed while the bigger performance work is underway. Checking for updates now answers in KiwiDesk's own window, the front app on the Space Bar gets an indicator of its own, and fonts with old-style numbers sit straight on the bar.

    Improved

    • The front app on the Space Bar now wears the active indicator too — its outline or edge mark, in the front app's colour unless you pick another under Advanced Colors ▸ Front app indicator.
    • Check for updates now answers in KiwiDesk's own update window, while it checks and when you're up to date, with this version's notes and Next on my list, now a tab of its own.
    • Picking the Pill or Sakura look now also sets its own font, Avenir Next or Hiragino Sans.
    • The Font weight slider now greys out for a font with fixed weights only, like Menlo or Apple Chancery, and shows the weight it draws instead of moving without effect.
    • Rounded chips on KiwiShelf now leave the same room at both ends, and an empty Space shown by a symbol is as round as a numbered one.

    Fixed

    • Space numbers now sit centred in fonts with old-style figures, like Apple Chancery or Georgia, instead of low.
    • Switching to an empty Space no longer leaves a dark box where the front app was shown.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v2.1.0...v2.1.1

  15. 2.1.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 2.1.0 makes KiwiShelf your own. Looks are ready-made shelf designs to start from: pick one, then change the font, the border, the glyph size, the colours and the edge of each bar until it is yours, and keep it as a Look of your own — kiwis come in green, gold and red, and your shelf in whatever you like. The Space Bar keeps the window you are in at the centre of its Space, and a Space made on the fly leaves when it empties. Plugging a screen in or out got smarter too: your windows go back where they were, and new ones wait together in a Space marked with a two-screen icon until their screen comes back. An update now leaves your windows where they are, and a long round of fixes rounds it off.

    App shortcuts now do what they were made for even when macOS keeps an app running with no window — Safari after its red close button, say: the shortcut brings its window back instead of doing nothing. New here, or not yet through everything KiwiDesk does on a chord or a swipe? Press ⌃⌥K for the overview, or open Shortcuts & Gestures in Settings, where each gesture comes with its own little preview — this release's included: a right-click on KiwiShelf for a menu of what you clicked, and moving through your windows and your Spaces with a trackpad gesture or your mouse.

    New

    • Looks: ready-made and saved KiwiShelf designs — Glass, Taskbar, Classic, Tiler, Pill and Sakura, each with its colours, where the bars sit, the focus border's shape and the gaps — on the page now called Looks & Animations, and as a step of the welcome tour. One look is shared across your profiles unless a profile keeps its own, and a new palette, Nightfall, joins the bundled ones.
    • Each bar can now sit on its own edge — KiwiShelf ▸ Position ▸ Each bar — and on different edges each is its own shelf. New setups start with the Space Bar on top and the App Bar on the bottom; yours stay where they are.
    • Right-click the KiwiShelf for a menu of what you clicked: a Space's layout, its settings, New Space and Delete Space; an app's New Window, Move to Current Space, Float or Tile, App Rules…, Close Window and Quit; and KiwiShelf Settings, Looks and Advanced Colors at the end of every menu.
    • Click an app glyph on the Space Bar to focus that window — a glyph standing for several opens a menu of them — and hover a glyph or an App Bar item for its full title.
    • Hold ⌃⌥ and scroll to move focus window by window, ⌃⌥⌘ and scroll to step between Spaces — trackpad or mouse wheel — set up under the new Shortcuts & Gestures ▸ Mouse & trackpad, which also shows what the mouse and trackpad do, in moving pictures.
    • Temporary Spaces: a Space you make on the fly — New Space on the bar, or a shortcut to a Space that doesn't exist yet — is marked with an hourglass, goes away once its last window leaves, and is never saved unless you add it to the profile in Settings ▸ Spaces.
    • The Space Bar gains Other Spaces — their apps, or just each Space's name with a window count — a Space label that draws the layout in place of the name, a switch for grouping a Space's same-app windows, and a gap between glyphs.
    • KiwiShelf ▸ Style gains a Font and Font weight for the bars' text, a Border around the plate or the boxes, a Glyph size and a Highlight width.
    • A sheen on the focus border, the shelf's highlight and border, and the drag borders — a lighter or darker top edge, set under Looks & Animations ▸ Sheen, and on for everyone.
    • Floating windows now wear a mark on the window, like sticky ones (Gaps & Borders ▸ Show mark on floating windows), and the App Bar now lists a Space's floating windows after its tiled row.
    • KiwiShelf now animates a Space switch: the App Bar grows out of the Space Bar and shrinks back into it, a bar on an edge of its own fades in and out, the row dissolves between two Spaces that both show one, and App Bar groups slide together and apart. Looks & Animations ▸ Animate KiwiShelf and KiwiShelf duration set it, and Reduce Motion lands everything at once.
    • What's new now ends with Next on my list — a dated list of up to three things I'm working on next.

    Improved

    • Floating a tiled window now centres it at a usable size — Float Window (⌃⌥F), or a Float rule saved over an open window — cascading when another float already sits there, and a window you float again returns to where it last floated.
    • Installing an update now leaves your windows where they are — Install and Relaunch from the update window, and kiwidesk service restart — sizes and scroll positions included; a quit still spreads them out.
    • On quit, windows now fill the screen in a balanced grid before they pile up — two side by side, four as a 2×2, the last one stretched over what is left — and entering or leaving the Floating layout does the same.
    • The update window now has tabs — Highlights, New, Improved, Fixed, Lua & CLI — and after Install, What's new opens again at once and says how far the start has got.
    • The Space Bar now keeps your focused window centred in each Space's row, with a +n on either side for the rest, and holds still while your pointer rests on it.
    • Plugging a screen in or out now remembers your windows: a window that was already open before you plugged in or out goes back to the Space it was in, and the ones opened since stay together in a held Space, marked with a two-screen icon on the Space Bar, that goes back to its screen when the screen does. Held Spaces keep their order and their hidden windows, survive a KiwiDesk restart, and a profile switch now holds any Space it has no name for while it has windows.
    • The alert sound and the quit grid's windows per pile are now app-wide, on General, applying without Save; the Behavior page is gone, and its mouse settings live under Shortcuts & Gestures.
    • Tile Window now says why it can't — an App Rule, a dialog or a missing Dock icon floats the window — and removing a Float rule now tiles its windows again.
    • The starter setup and the workflow presets are now tuned to the shape of your screens — an ultrawide scrolls wide, a portrait screen scrolls tall — and Visual Creative & Developer is now called Design Studio.
    • The welcome tour can now be replayed any time from the bottom of Settings Home, and its layout thumbnails, like the preset previews, play their layout once.

    Fixed

    • Open or Focus now reopens an app that is running with no window, and lands on the window you used last — right after a Space switch it used to do nothing.
    • Scrolling the shelf no longer stalls under a boxed Liquid Glass bar.
    • A slide show or a borderless-fullscreen game now opens in front, and the bars get out of its way.
    • In a Scrolling Space, dragging the outer edge of the first or last column now resizes it instead of snapping back.
    • Windows on Spaces you aren't looking at no longer flash onto the screen at launch, and a Monocle Space's windows no longer come back at half size after a relaunch.
    • A floating window dragged onto another display now belongs to that display's Space — tiling it no longer sends it back across, and switching the old screen's Space no longer parks it.
    • A tiled window moved into a Floating Space no longer lands partly off-screen, and a floating window no longer hides behind the tiles after a move-and-follow.
    • Orion's second profile now tiles, and its invisible preview twins no longer take a slot or trade focus with their window.
    • A Space no longer gets a second digit shortcut after you reorder Spaces, and a duplicate already in your saved shortcuts is dropped once.
    • A shortcut recorded in Settings now takes effect on Save, like every other setting — it used to work at once and vanish on the next start.
    • A profile's memory of which windows sit in which Space now survives a restart, and quitting under one profile and starting under another no longer puts the first one's layouts on the second's Spaces.
    • A Space chip no longer keeps its hover after a click switched Spaces, a full bar's end items no longer touch the border, and switching Boxed to Plain no longer clips the items.

    Lua & CLI

    • If you write your own Lua config: make_auto is retired — make_tiled does its job, and fails on a window a rule or detection floats; set_float_nudge becomes set_float_placement("center" | "keep"), a saved nudge-off reading as keep; kiwishelf.set_edge is space_bar.set_edge and app_bar.set_edge; space_bar.set_glyph_cap is space_bar.set_glyph_span; drag.set_ghost_border_width and drag.set_drop_zone_border_width are border.set_width, and drag.set_corner_radius is border.set_corner_style; and app_bar.set_content, monocle.set_app_bar_content and scroll.set_app_bar_content are gone, the App Bar always drawing icon and title. Each old call is reported in Config Issues with its replacement.
    • The move and float verbs now take a window: move_to_space, move_to_space_and_follow, make_floating, make_tiled and toggle_floating accept a window id from get_state as a last argument and act on that window instead of the focused one.
    • New: new_window and close_window, with the same optional window id — they press the app's own File ▸ New Window and the window's close button.
    • create_space and delete_space now take a scope, session (the default) or profile, which also writes the live profile's file; a Space created from a keybinding or the CLI is temporary.
    • set_refusal_sound, quit.set_layout and quit.set_grid_target_depth now change the running value only — the settings are app-wide in gui.json, and no profile carries them.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v2.0.0...v2.1.0

  16. 2.0.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 2.0.0 puts the Space Bar and the App Bar on one shelf, KiwiShelf: one edge, one look, one set of colours. It declutters the interface — settings the two bars each carried are now one — for a simpler, more consistent experience. Profiles take a firmer hold on your screens and Desktops — unplugging a screen keeps its Spaces until it comes back, a Desktop can load a profile for one particular screen setup, and App Rules and shortcuts say which profiles they apply to. KiwiDesk also brings its own update window, more Liquid Glass, a reworked App Rules page and a round of fixes.

    Before you update: Your settings carry over on their own. The two bars now share one edge and one style, and where they differed the shelf takes the Space Bar's — so with the usual setup, the App Bar in a Monocle or Scrolling Space moves up to the top beside the Space Bar. Settings ▸ KiwiShelf & Bars moves the shelf.

    New

    • KiwiShelf now puts both bars on one shelf — one plate with a divider between them, and when the shelf is full, drag the divider to give the Space Bar more room; double-click resets it.
    • A bar with more than fits now fades at its edge and shows a count you can click to page; the mouse wheel and the trackpad scroll it.
    • New outer and inner margins set how far the shelf sits from the screen edge and from your windows.
    • Unplugging a screen now keeps its Spaces on the screen that remains, windows and layouts included, marked ✱ — plug it back in and they go home. A held Space is never saved into a profile.
    • A Desktop can now load a profile for one screen setup — your desk's monitors, say — ahead of the profile bound to it for every setup with that many screens.
    • App Rules and shortcuts now say which profiles they apply to: All profiles, or the ones you tick, and a profile can leave a shared shortcut out.
    • Opening an app whose App Rule sends it to another Space now takes you there with its window.
    • KiwiDesk now has its own update window, listing everything changed since your version as New, Improved, Fixed and Lua & CLI; after an update, What's New shows the same.
    • New: Install updates automatically, under Settings ▸ General, installs a downloaded update the next time KiwiDesk quits. It is off by default and never restarts KiwiDesk by itself.
    • KiwiDesk now has a Discord community, and Settings Home now ends in the community links — Discord, GitHub and Ko-fi — with the version, the update state and About below. Check for Updates… moved there from the menu bar menu, which shows Update Available… only when an update was found.
    • With the Space Bar off, the menu bar icon now shows the Space each screen is on, and the active layer when it isn't the default one.
    • With Liquid Glass on, the drag markers and the sticky mark are now glass too, each tinted by its own colour.

    Improved

    • On Liquid Glass, the shelf's colour now fades from the screen edge toward your windows, so the glass reads lighter.
    • Each screen setup now belongs to one profile — the last one you saved or loaded with it — so connecting those screens loads the profile you expect.
    • App Rules is now two lists, Open in a Space and Float, and adding a rule starts by choosing which; a rule can no longer be one that does nothing.
    • The Profiles page now counts screens and Spaces instead of drawing them, deleting a profile asks first, and "make default" names the screen count it is for.
    • In Settings ▸ Spaces, + with an empty name now adds the next free number, and a name another Space already has now says so instead of silently reverting.
    • A window you close and bring back now opens where you are, and focused, like a new window — a deliberate choice: a window manager opens windows in front of you, and you can move them from there.
    • In Stack, dragging a window's edge along its column now resizes it instead of snapping back, as the keyboard does.
    • KiwiDesk now stays smooth while a browser or terminal retitles its window on every page load or command.

    Fixed

    • The bar no longer stays under the menu bar after turning the menu bar's auto-hide back off.
    • Disconnecting a screen or a Vision Pro no longer briefly loads the wrong profile before the right one.
    • A window set to stay visible across Desktops now follows a trackpad swipe to another Desktop.
    • An app's right-click menu no longer closes on its own when an App Rule puts that app in another Space.
    • With the menu bar on auto-hide, reaching the top edge no longer takes focus away from the Settings window.
    • ⌘W now closes the Settings window.
    • A Space 1 you had renamed or deleted no longer comes back on every launch.
    • App icons now sit centred and whole in the bars, a thin Space Bar included, and Adobe apps and others with a version in their name get their icon again.

    Lua & CLI

    • If you write your own Lua config: the bars' shared setters — edge, alignment, thickness, background style and fit, Liquid Glass, corner roundness, item gap, font size, icon source, dim factor and the colours — move from space_bar.set_*, app_bar.set_*, monocle.set_app_bar_* and scroll.set_app_bar_* to kiwishelf.set_*. init.lua is not rewritten; each old call is reported in Config Issues with its replacement.
    • item_size is retired — an App Bar's width follows its title_cap, a Space Bar item fits its content — space_bar.set_title_cap is now space_bar.set_front_app_title_cap, and the gap active indicator is gone.
    • New shelf setters: kiwishelf.set_minimum, kiwishelf.set_order, kiwishelf.set_outer_margin and kiwishelf.set_inner_margin; drag.set_liquid_glass and sticky.set_liquid_glass join the Liquid Glass switch.
    • reset_layout_sizing now returns the active Space, one Space or all to the sizes your profile set.
    • bind_profile_to_desktop now takes screens to scope a binding to one setup, and save_profile and load_profile say when they took a screen setup from another profile.
    • delete_space now names what would bring the Space back — a profile, init.lua or your Settings.
    • monitor_change now fires once the screens have settled, rather than for each in-between report.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.4.0...v2.0.0

  17. 1.4.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 1.4.0 makes ultrawide screens comfortable — a Scrolling Space says how many windows it shows, and the anchors put the focused window where they say — and brings profiles and macOS Desktops into step, with one profile per screen count and windows returning in the order you left them. Beside that, a card flip when focus moves in a Monocle Space, and a round of fixes.

    Desktops and profiles

    • A Desktop can hold one profile per screen count — bind a one-screen and a two-screen profile to the same Desktop and the one matching the screens connected loads when you dock or undock. The Desktops card groups its rows by screen count and names the screen under each Desktop.
    • Switching to another Desktop and back keeps your windows in order, and a Track Space keeps its columns.

    Windows and layouts

    • A focus change in a Monocle Space flips a card instead of cutting straight to the next window: the windows blur and a card turns from the outgoing app's icon to the incoming one's. On by default — Flip between windows and Flip duration are under Layout Defaults ▸ Monocle, and macOS's Reduce Motion keeps it off.
    • A Scrolling slot of 50% is exactly two windows, gaps included, and a Windows on screen stepper under the slot size sets the count directly; the split ratios gain ¼ ⅓ ½ ⅔ ¾ presets. A saved slot size moves by less than one gap.
    • The Left, Right, Top, Bottom and Center anchors now mean what they say: the focused window rests at that position even when the row is shorter than the screen, so the rest of the row can hang off the edge. If you'd rather have the screen always filled with windows, use Follow — it's unchanged, and still the default.
    • If one window, fill the screen is a new toggle for Scrolling and Stack, on by default. Off, a lone window keeps its slot size or master zone and the rest of the screen stays empty.
    • In Track, a window with a fixed size no longer hogs the width — the leftover goes to the columns beside it, which you can resize again, and switching Spaces and back keeps the arrangement.

    Borders and gaps

    • The unfocused border is visible again on the dark palettes — six of the built-in palettes drew it too dark to see over dark wallpaper, and each takes a lighter grey now.
    • Fit layout gaps makes room for the glow, so a focused window's glow no longer bleeds onto its neighbour, and the button now lives in the Gaps card.

    Settings and shortcuts

    • ⌃⌥, opens Settings on a new setup, beside ⌃⌥K. An existing setup gets it through Shortcuts ▸ Restore Defaults…
    • The gap sliders and the Desktop binding rows stay live — the sliders while the per-edge values differ (a value there sets all of them), the rows while you edit a stored profile, and Save keeps the binding.
    • Rows with no effect are greyed and say why — Auto Glow Size with the glow off, Liquid Glass while Reduce transparency is on.
    • The icon picker for Spaces and layers opens on Symbols rather than on whichever tab you left it. Furthermore, the picker's search is cleared when it's closed.
    • On macOS 27, Settings' dropdowns keep their text grey — the new OS tinted every pop-up's label green while Settings was the front window.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.3.0...v1.4.0

  18. 1.3.0

    Expand

    GitHub Release

    KiwiDesk is built in free time and is free to use for everyone. If it has earned a place on your Mac — a star on GitHub, a word to someone who tiles, or a coffee through GitHub Sponsors or Ko-fi — every one of those keeps it fruity.

    Highlights

    KiwiDesk 1.3.0 is the first release under the Business Source License 1.1 — free to use for everyone, business included; only offering it as a product or service is reserved, and each version becomes MIT after four years. Beyond that: Liquid Glass on by default, a Mac Checklist in Settings, windows that respect an app's own minimum size, a swipe that stays where you sent it, and a Settings window that comes to the front when asked.

    Liquid Glass and the bars

    • Liquid Glass is on by default on macOS 26, and it honours Reduce transparency the moment you switch that on. A setup that had it off keeps it off.
    • Both bars start at 40 pt thick on a new setup, on every screen size, and the Thickness sliders now go down to 20 pt.
    • The Space Bar shows which shortcut layer is active, leading with the layer's icon while one other than the default is on — and scripts can hear the switch as a layer_change event.

    Windows and layouts

    • An app's own minimum size is respected, and the resize pill says whose limit you hit. A split makes room for a window that won't go narrower instead of letting it overlap its neighbour, Track opens only as many tracks as fit, and This app won't go smaller names the app where Minimum window size reached still means the setting you can lower.
    • A double-clicked title bar or edge no longer knocks a tiled window out of its slot, nor does an app resizing itself — the window goes straight back, and a floating window that zooms is kept clear of the bars.
    • Switching a Space to Floating no longer leaves windows off screen or piled on top of each other — anything you couldn't reach is laid out in a grid.
    • The Track limit is the number of tracks you see. A limit of 3 used to show four; the default is now 3, and saved configs are adjusted on first load so nothing moves on screen.
    • Floating windows get the unfocused border too, and clicking around a Floating Space no longer lifts a sticky window over the others.

    Desktops and profiles

    • A swipe to another Desktop no longer gets pulled back a second later.
    • A Desktop binding fires only when its profile fits the screens connected. Bound to a one-screen profile with two screens plugged in, the Desktop takes the profile for that screen count instead, and the Desktops row says which count the binding is for.

    Settings

    • Settings opened from the menu bar comes to the front again, including after you closed it once in a Scrolling Space.
    • A Mac Checklist card lists the macOS settings a tiling window manager fights — Stage Manager, rearranging Spaces by use, edge tiling — read live from your Mac, with the habits that make tiling stick. The guide link now lives at its foot, and the tour ends there.
    • Search opens the drawer a setting hides in, and finds your palettes by name.
    • The Track shortcuts sit behind their own drawer — Move windows in the track layout, below the Desktop one — instead of beside shortcuts every layout uses.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.2.2...v1.3.0

  19. 1.2.2

    Expand

    GitHub Release

    Highlights

    A one-fix release: floating windows that come back where you left them.

    Floating windows

    • A floating window no longer gets stuck in the screen corner. Switching spaces could lose where a floating window belonged — after a Desktop switch, a relaunch, or simply a slow app — and from then on it came back tucked into the bottom corner where hidden windows park. Its place now survives all three, and a window whose place is genuinely lost comes back centred on its screen instead of in the corner.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.2.1...v1.2.2

  20. 1.2.1

    Expand

    GitHub Release

    Highlights

    A small release: Desktop switches that stay put, profiles that keep their arrangements, and an update you can actually see.

    Desktops

    • A swipe to another Desktop stays there instead of bouncing you back a moment later, and the swipe back keeps the window macOS refocused.
    • Switching Desktops no longer reads or rewrites your profile files. A hand-edited profile takes effect at the next reload or apply.

    Profiles

    • A profile keeps the arrangement you left it with through a Settings save, a preset, a discard, Reset All Settings and a backup restore — a window parked on another Desktop included.

    Updates

    • You are told when an update is waiting: an orange dot on the menu-bar icon and an Update Available… row, instead of a window opened behind everything else.

    Settings and the command line

    • The Desktop shortcut drawers explain themselves with a ? that says what a macOS Desktop is next to a KiwiDesk Space.
    • focus_desktop and move_to_desktop_and_follow return switched, false when the Desktop was already showing.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.2.0...v1.2.1

  21. 1.2.0

    Expand

    GitHub Release

    Highlights

    This release is about macOS Desktops. KiwiDesk now knows which windows live on the Desktops you are not looking at, keeps each Desktop's and each profile's Spaces apart, brings sticky windows along when you switch, and puts focus back where you left it when you come back. Around that: a keyboard preview you can read, one honest cue for every blocked resize, and several focus jumps that are gone — including the one that pulled you off a fullscreen video. Liquid Glass now covers every KiwiDesk surface from a single switch, and three long-standing translation defects are fixed.

    Desktops, done properly

    • Every profile owns its own Spaces. Two profiles' Space 1 used to be one Space, so switching profiles and back could merge an arrangement away for good. Each profile now records what its Spaces held when you leave it and restores them when you return. A brand-new Desktop picks a Space no other Desktop is showing instead of landing on one whose windows are all somewhere else.
    • A Desktop keeps its identity when Mission Control renumbers it. Adding, removing or dragging a Desktop — or plugging a screen in — shifts every Desktop number, and everything keyed by number silently pointed at a different Desktop. KiwiDesk now stamps each Desktop with its own identifier, so profile bindings and remembered Spaces stay with the Desktop they were made on.
    • Windows on other Desktops are known, not forgotten. KiwiDesk reads which windows each Desktop hosts, so a window that vanished because you switched Desktops is reported as away rather than closed, keeps its Space and slot for its return, and Open or Focus can reach it across Desktops. get_state lists them under away_windows, and startup no longer counts parked or system windows among them.
    • The Space Bar shows the Desktop in front of you. Windows parked by KiwiDesk in another Space are the bar's job; windows sitting on another macOS Desktop are not, and no longer appear.
    • Sticky windows come with you across Desktops. A window marked ∞ follows you to every Desktop; one marked 📌 follows across its screen's Desktops. On by default and switchable with sticky.set_desktop_reach, with a per-window override for the one window you want left behind.
    • Coming back to a Desktop puts focus where you left it. Returning used to jump focus to the first window in the row; KiwiDesk now remembers each Space's last focus per Desktop and hands it back at that window's own return.
    • Move a window to a Desktop and into a Space in one verb. move_to_desktop(3, "mail") and move_to_desktop_and_follow take an optional Space the window joins when it lands.
    • A ∞ window entering a floating Space on another screen moves onto that screen, scaled to it, instead of staying where its previous Space drew it — and its ∞ mark shows on the one bar that actually has it.
    • A new docs page explains how screens, Desktops, profiles and Spaces relate, with a diagram — the model the app assumed you already had.

    Liquid Glass, and the bars

    • Liquid Glass is one switch, and it covers everything. It used to be an App Bar setting alone. It now lives in Colors & Animations and lays macOS's translucent material over the Space Bar, the App Bar and the shortcuts panel together, with each bar's Fill colour tinting its own material. The shortcuts panel stays untinted on purpose — a large panel summoned over the desktop reads best as clear glass. If your three surfaces are set differently today, turning the switch on adopts all three.
    • The bars honour Reduce Motion. With the system setting on, a bar no longer slides or fades — it just appears where it belongs. The affordance stays; only the motion goes.

    Focus stops jumping

    • KiwiDesk stops believing focus reports that are not yours. Apps announce focus changes that are not system focus changes: a window re-focusing itself a second after KiwiDesk places it, a duplicate report landing after your next keypress, a small panel that takes the keyboard without bringing its app forward. Each one moved KiwiDesk's idea of focus off the window you were actually on — and at worst left every focus shortcut refused until you clicked a window to resync. All three are recognised now.
    • A window that blinks out keeps its place. Some browsers drop their window for half a second entering and leaving native fullscreen, and some apps stop reporting a window during fast focus changes. Both read as a close, so the window lost its slot and focus moved to a neighbour. Leaving a fullscreen video now returns you to the video.
    • Clicking KiwiDesk's own Settings window focuses it. On a scrolling Space, clicking another window pans Settings out of view — and clicking it again within two seconds did nothing at all.

    Resizing tells you why it stopped

    • Every blocked resize draws a pill, and a drawn pill may sound. A resize press in a layout with no resizing, or on an axis the zone does not have, used to be cued by sound alone — invisible with sound off. One cue now covers every refusal.
    • The pill lands on the window that cannot move. In BSP a refusal named the focused window as at its minimum when a neighbour was the one stuck, sending you to resize the wrong window.
    • A window alone in its zone says so. "Nothing to divide here — try the other axis" and "This zone has nothing to divide" replace six silent cases and one message that was false; a one-window stack no longer shows a row of "Minimum window size reached" pills on a window filling the screen.
    • Two more presses now answer properly. A native full-screen window is refused, and says so, in every layout — it used to be silent in one and shove its neighbours around in another. And a window floating because its whole Space uses the floating layout now resizes like one, which until now only windows you had floated by hand did.

    Shortcuts you can read

    • The keyboard preview answers a real question now. Hover a key to see every action on it, chord first, with what a collision costs spelled out — the red key finally says which two bindings collide. And the board draws the layer you are editing, so "is this key free here" is answered for the layer that will actually fire rather than for all of them at once.
    • A conflict warning names the cost, not just the collision, and reads macOS's live shortcut settings: a system chord you have turned off no longer counts as a conflict, and one you turned on does.
    • Swap rides ⌃⌥⌘ plus an arrow; ⇧ keeps the digits. The three-modifier claw for swapping is gone: ⌃⌥⌘ with an arrow swaps with a neighbour, ⇧ with a digit sends the window to that Space. Fresh installs get the new defaults; a keymap you edited is yours and does not move.
    • Per-Desktop shortcut rows appear once you bind one. A dozen unbound "Go to Desktop N" rows no longer sit in the Focus and Move cards on every Mac with several Desktops.
    • The shortcuts panel says when it has more to show. On a default install the panel is taller than its ceiling and scrolls, and nothing said so — the rows below the fold were simply not there as far as you could tell.
    • Picking an app binds it, in one press. Choosing an app for a shortcut no longer needs a second button afterwards, which is how app rules have always worked.

    Settings

    • Export Log… in General ▸ Advanced. Pick a time range, save the file, attach it to a bug report — no terminal needed.
    • Picking an app adds its rule immediately. The separate "Add app rule" button is gone, and with it the half-added state that drew no icon.
    • Keyboard navigation got shorter and quieter. Arriving in an area focuses the page instead of the back chip (six presses fewer to the first field), a segmented control costs one Tab stop instead of one per segment, and the focus ring appears only when the keyboard asked for it — mouse clicks no longer draw one, the Space chip included.
    • The save pill lists the screen changes the header claims. Clicking it opened nothing when the only unsaved change was a screen setup drifting from the profile.
    • The profile card's help states the rule correctly: the main screen's Desktop selects the profile, and all four rungs of the selection ladder are there.
    • "Save as new" says screen, and speaks every language. The message called a screen a monitor and was missing from every non-English catalog.
    • Bar titles default to ten characters. The bars show window titles, and each item is sized from the widest, so the old 25-character default spent the bar before you chose anything.
    • And a run of smaller fixes. The hex field in Advanced Colors can be clicked into, the app picker finds apps in subfolders and both of its surfaces answer Escape alike, the Space chips in Monitors show they can be dragged, a profile card stays marked while you point at another, and Save is readable in light mode while Settings is inactive.

    In your language

    • Switching language now changes every label. Some lists — the bars' Position and Alignment pickers, the shortcut recorder's help — kept whichever language was live the first time you opened that page, so the window came back part English and part German.
    • Track shortcut rows read as sentences. "Move window to next track" was assembled from a bare "next", which five languages cannot inflect into a sentence; each row is now translated whole.
    • The shortcuts panel has one name. Everything pointing at it said "shortcuts panel" while the panel announced itself to VoiceOver as "Shortcuts reference".

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.1.2...v1.2.0

  22. 1.1.2

    Expand

    GitHub Release

    Highlights

    Switching a layout from the menu bar and then saving in Settings used to undo the switch — that is fixed, and the menu row that makes a switch permanent now says what it does. BSP also picks a new default split, which changes how untouched setups tile.

    Saving in Settings stopped undoing your layout

    • Save no longer puts the old layout back. Switch a Space to Monocle from the menu bar, then open Settings to change a gap and press Save: the Space used to snap back to whatever the profile held, and that is what got saved — the switch was destroyed by saving something unrelated. Save now touches only what you changed in Settings, so the gap is saved and the Monocle switch stays on screen, still temporary until you keep it. Changing a Space's layout in Settings itself is a real edit, and that one wins.
    • The menu row is now "Keep Layout in Profile ‹name›". Same action, honest name: a layout switched from the menu bar is temporary until you keep it, which is how macOS words this choice elsewhere.
    • That row lights up whenever any screen is on a temporary layout, not only the screen you are looking at. It writes the whole profile, so it used to grey itself out while another screen's menu said the layout was unsaved.
    • Settings no longer narrates temporary layouts at all. The menu bar's "not saved to profile" line is now the single place a temporary layout is announced — and Revert went back to being just "discard my edits".

    BSP splits alternately now

    • New windows alternate horizontally, then vertically, as they nest. That alternation is what most people mean by BSP; the old default cut each area's longer side, which read as the layout misbehaving rather than as a choice. Both options are still there, in BSP's settings and in bsp.set_strategy.
    • This changes how you tile if you never picked a strategy. If you did pick one — in Settings or in your config — it is stored and nothing moves. Fresh installs and untouched setups get the new default.

    Floating spaces respect your bars

    • A window in a Floating space is now pushed clear of the App Bar and the Space Bar, the same as a window you floated by hand. It could previously sit underneath one with its title bar covered, and nothing ever moved it back out.

    Smaller things

    • Settings shows just the version number. The build hash moved to kiwidesk --version, which is where support asks for it.
    • Release plumbing: the release notes and the update feed publish themselves again, without a hand on the wheel.

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.1.1...v1.1.2

  23. 1.1.1

    Expand

    GitHub Release

    Highlights

    A small patch about focus: one fix for the moment your Mac wakes, one for the keyboard path in Settings. The rest is housekeeping — the site now names the sticky feature what Settings names it, a localization tool refuses a half-redirect it once obeyed silently, and a broad comment trim landed across the Settings tree.

    Waking up

    • Shortcuts work right after your Mac wakes. Waking or unlocking used to restore your focused window on screen — ring, bars, everything — while macOS quietly kept another app in front, so every shortcut was denied until a rescue click produced a real focus change. The wake restore now actually hands that window the focus (and when it is gone, the window genuinely in front), and if macOS refuses the handoff, the first key press heals it instead of dying.

    The Settings keyboard path

    • Jumping between areas keeps the keyboard with you. Following a cross-reference link, or picking a search result that lives in another area, left keyboard focus stranded at the top of the window. It now lands on the ← Home chip, exactly as opening an area from Home always did, so Tab keeps walking from where you are. (As before, full keyboard access needs System Settings ▸ Keyboard ▸ Keyboard navigation turned on.)

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.1.0...v1.1.1

  24. 1.1.0

    Expand

    GitHub Release

    Highlights

    The release where resizing a window started telling you the truth, and where the keys got out of your way. Most of what changed you will notice without looking for it. It gets more technical as you read down — and four things need a minute of your attention, marked where they come up.

    Resizing, made honest

    This got the most attention of anything in the release, because nearly every complaint about it turned out to be the same thing: KiwiDesk was resizing something other than what you asked, or refusing for a reason that did not exist.

    • A resize press acts on the focused window, measured from the size it is actually drawn at. Before, the first several presses could do nothing visible, or silently resize every neighbour instead.
    • Holding the chord resizes continuously, at your display's refresh rate, rather than stepping along a key-repeat timer that got slower the longer you held it.
    • A floating window grows and shrinks from both edges, keeps working when it is parked against the edge of the screen, and will not grow underneath a bar. Held resizing on a floating window now travels the whole distance you asked for — with Reduce Motion on, it used to deliver under a third of it.
    • When an app refuses to go smaller or larger, you are told on the first press. "Maximum window size reached" is a message now, in your language, instead of ten silent presses followed by the window snapping back.
    • Resizing stopped stalling. A pass that froze for up to two seconds and then jumped now runs clean; in the measured session, forty-two stalls became one.
    • Scrolling spaces stopped sliding. Resizing no longer drags the focused window toward the leading edge, a slot cannot be grown past what is drawn, and a window resting against the trailing border keeps that border.
    • Apps that fight back are handled. The Android emulator and its kind used to send tiling into an endless expand-and-snap loop about once a second. Now there is one adjustment when the window appears, and then the row settles.

    A keyboard layout that gets out of the way — and how to take it up

    The shipped shortcuts were re-measured against what macOS and common apps actually claim, and moved accordingly.

    • Resizing has its own layer, ⌥⌘, on digits rather than arrows — ⌥⌘1/⌥⌘2 for width, ⌥⌘4/⌥⌘5 for height. Arrows were rejected because ⌥⌘ with arrows is next and previous tab in most browsers and terminals, and those have no menu to fall back on.
    • ⇧ means one thing again. Sticky moved to ⌃⌥S for everywhere and ⌃⌥P for this screen only.
    • The numeric keypad works. Keypad digits fire the same bindings as their number-row twins — so if you already have space shortcuts on ⌃⌥1 through ⌃⌥9, they start answering the keypad the moment you upgrade, with nothing to configure.
    • Worth knowing: none of the other shortcut changes reach an existing install by themselves. The shipped set is seeded only into a configuration that has no shortcuts at all, so it never overwrites anything you or your Lua wrote. If you have been using KiwiDesk, your keys are exactly where you left them.
    • Restore Defaults… is how you take them up, at the top of Settings ▸ Shortcuts. It puts back the set a fresh install would get — for your Desktops and your resize step, not a fixed list — including defaults added since you installed. Your own shortcuts are kept. The one exception is a shortcut of yours sitting on a key a default needs, which cannot stay without putting two bindings on one key; the confirmation counts those before you agree, and says so plainly when the answer is none. Settings search finds it under "restore", "defaults" or "reset".
    • The guide now teaches how to choose a shortcut of your own — what makes a chord safe, why ⌃⌥ is the quiet corner, and the one thing worth doing before you commit to a new one. In English, German and Japanese.

    Reduce Motion and VoiceOver

    • Reduce Motion is honoured across Settings. Layout previews arrive instead of springing, and fifty-one animation sites that ignored the system setting now stand down with it.
    • Starting VoiceOver no longer steals your focus to a different app a few seconds later.
    • Drawer headers behave as one thing across fifteen drawers, and all of them join the VoiceOver headings rotor.

    Start at login does one job now

    • The switch installs the login item and nothing else. Crash supervision used to ride along with it, unasked. It is still available, deliberately, as kiwidesk service from the command line.
    • If you relied on that supervision, turn it on explicitly after upgrading. Nothing else changes for you.
    • Turning Start at login on while KiwiDesk is running no longer steals focus every ten seconds, indefinitely.
    • The update prompt comes to the front when it is ready to install and restart, instead of waiting behind every other window where it could not be found.

    KiwiDesk can move around macOS's Desktops

    • Switching Desktops and sending windows between them now works — on stock macOS, with System Integrity Protection on. This was listed as impossible for most of KiwiDesk's life. Two new commands, focus_desktop and move_to_desktop, and the Space Bar and shortcut editor speak them like anything else.
    • A switch KiwiDesk drives performs the real transition, instead of leaving two Desktops drawn on top of each other for a moment.
    • Moving a window to another Desktop and following it lands your keyboard focus on that window, every time, rather than most of the time.
    • A window sent to a Desktop on another screen stays there instead of springing back to where it came from.
    • Switching Desktops settles immediately. It used to take five to ten seconds to stop rearranging, even switching to an empty one.

    Scripting

    • Every command describes itself. kiwidesk list_commands now documents all 262 — group, typed arguments, and a one-line summary each. kiwidesk help <command> works, and list_commands <group> filters instead of returning everything.
    • Output is readable at a terminal and unchanged in a pipe. Pretty-printed when you are looking at it, the same compact line when a script is reading it. Keys are sorted either way.
    • One rename needs your hand: animations.set_scroll_speed is now animations.set_scroll_duration. It always was the duration — raising it made scrolling slower — and the setting is renamed in the interface to match. Your stored configuration is migrated for you. Lua is not, on purpose: if your init.lua or one of your keybindings calls set_scroll_speed, it will fail loudly at the moment you press it, which is better than failing silently. Rewrite it once and it is done.

    Also

    • New installs open in Scrolling on every screen but the smallest, with a deliberate slot width instead of an automatic one. Existing setups are untouched.
    • One word per concept, in every language. Width, floating, the Track unit, and "make it bigger" each had two words in at least one language and now have one. Japanese and Korean can now tell Go to Space from Move to Space, and German and Korean can tell the shortcuts a profile inherits from the ones KiwiDesk ships.
    • The Restore Defaults confirmation speaks your language. It was English everywhere but English — at the one moment it is telling you what you are about to lose.
    • Your profiles move to a newer format the first time this version saves one, which means 1.0.1 cannot read them afterwards. Nothing to worry about: kiwis only grow, they never shrink back. 🥝

    What's Changed

    Full Changelog: https://github.com/KiwiCanopy/KiwiDesk/compare/v1.0.1...v1.1.0