On this page6 sections
Guide

A calmer Mac, in a few minutes

No manual, no setup rituals. This is the friendly tour — what KiwiDesk does, how to make it yours, and whether it's the right fit. Scroll through, or jump to any part from the list.

Step one

Getting started

KiwiDesk is in public beta, and installing it takes about a minute.

🥝 Public beta

Open Terminal — press ⌘Space, type “Terminal”, press Enter — then paste this line and press Enter:

Terminal
brew install --cask kiwicanopy/tap/kiwidesk

This installs from KiwiCanopy's own Homebrew tap — the same people who make KiwiDesk.

Don't have Homebrew yet?

Homebrew is the package manager the command above uses. Paste this first, then the line above.

Terminal
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

A signed direct download follows once the app can update itself; until then Homebrew is the way in, and brew upgrade keeps it current.

Requires macOS 14 or later.

The one permission it asks for

The first time you open KiwiDesk, macOS asks you to grant Accessibility access. This is the normal, expected prompt — and it's the only thing KiwiDesk needs from you. To tidy your screen, it has to be able to move and resize your windows, and macOS keeps that ability behind this permission. A short onboarding wizard walks you to the right spot in System Settings › Privacy & Security › Accessibility and helps you switch it on.

What it never does

KiwiDesk stays entirely in normal user space, so the things people worry about simply aren't part of how it works:

  • It never asks you to disable SIP (your Mac's built-in System Integrity Protection). Your Mac's protections stay exactly as they are.
  • It never needs Input Monitoring. Its keyboard shortcuts use a built-in macOS mechanism, so it isn't — and can't be — a keylogger.

Your first tidy desktop

With the permission granted, KiwiDesk gets to work. The moment you have a window open, you'll see it settle neatly into place — filling its share of the screen, edge to edge, with no overlap. Open a second and the two share the space side by side. Nothing is buried, nothing is hunted for. You keep working the way you always do; the arranging just happens.

The shapes

The layouts

A “layout” is just the shape your windows arrange themselves into. KiwiDesk has seven. You don't have to learn them all — most people find one they like and stay there. Here's each, in plain language.

Stack

One big window holds your focus, with the rest lined up neatly beside it — glance over.

BSP

Windows split the screen into tidy panes, each new one halving the space it lands in. Balanced, edge to edge.

Scrolling

Windows sit in a row you scroll through, like columns on a long desk — the focused one always front and center.

Monocle

One window fills the screen while the others wait quietly behind it. Pure focus, no distractions.

Grid

Everything laid out in even rows and columns — see all your windows at once, each with its own equal square.

Track

Side-by-side columns (or rows), each holding as many windows as you like — one column per task or project.

Floating

The plain macOS way: windows float freely, right where you drag them. KiwiDesk leaves these ones alone.

Make it yours

Finding your favorite

The best way to find your layout is to try a few and feel which one suits your day. Open the Settings window from KiwiDesk's menu-bar icon, go to Layout, and pick a mode for the space you're on. Your windows rearrange right away, so you can see each one live — switch, look, switch again.

When one feels right, it's already saved for that space. You can even give different spaces different layouts: a focused stack for writing, a wide scrolling row for research, whatever fits.

It's okay to change your mind

Nothing here is permanent. Switch layouts as often as you like — there's no wrong choice, and you can always go back. KiwiDesk only ever moves and resizes windows; it never touches your files or your apps.

Point and click

The Settings app

Everything is point-and-click — you never need to edit a file. Open Settings from the KiwiDesk menu in your menu bar. A sidebar on the left groups things into Design (the look and feel of the profile you're working on) and System (settings that apply everywhere). Here's what each section is for.

  • Spaces

    Name the workspaces you use — “web”, “mail”, a number — and KiwiDesk keeps each one tidy on its own.

  • Layout

    Pick a layout for each space and set the gaps between windows. This is where you choose your favorite arrangement — and, if you like, give one space its own tweaks without changing the rest.

  • Monitors

    Have more than one display? Pin a space to a screen by dragging it onto that monitor. Handy when you dock and undock.

  • Appearance

    Tune the little visuals — the soft highlight that shows where a window will land as you drag it, the ring around the window you're focused on, and the small marks that flag windows set to float or stay pinned.

  • Bars

    Two optional on-screen strips. The Space Bar shows all your Spaces at a glance — click one to jump there, or drag a window onto it to send it over. The App Bar lists every window in the monocle and scrolling layouts, so nothing hides; click a tab to focus it, or drag tabs to reorder. Little badges mark windows that float or stay pinned everywhere.

  • Behavior

    Adjust how things feel: how quickly windows glide, what happens on wake from sleep, where new windows appear, and how KiwiDesk tidies your windows into a reachable grid if you ever quit it.

  • Profiles

    Save a whole setup as a profile and switch between them — one for focused work, another for a second screen at your desk.

  • Shortcuts

    See and change the keyboard shortcuts, recorded by simply pressing the keys you want. Every conflict is flagged for you.

  • App Rules & General

    Automatically send an app to a chosen space every time you open it, keep certain windows floating, and pick the Settings language — all point-and-click.

Good questions

FAQ

Do I need to know Lua or write any code?

No. The Settings app covers everything — layouts, gaps, monitors, shortcuts, app rules — all with clicks and sliders. Lua is there for tinkerers who want to script their setup, but it's entirely optional. Most people never open a config file.

Does it replace Mission Control or Spaces?

No — it works alongside them. KiwiDesk arranges the windows within your workspaces; your macOS desktops and Mission Control keep working just as they do now. You can even assign a different setup to each Mission Control desktop, so it switches automatically as you move between them.

Is my data private?

Yes. KiwiDesk runs entirely on your Mac, in normal user space. It only moves and resizes windows — it never reads your files, and it isn't a keylogger (its shortcuts use a built-in macOS mechanism, not keyboard monitoring). It never asks you to weaken your Mac's built-in protections.

Will it slow down my Mac or drain the battery?

KiwiDesk is a small, native macOS app built to sit quietly in the background. It only does work when your windows actually change, and its animations run at each display's own natural refresh rate. Day to day, you shouldn't notice it in the background at all. If you'd rather skip the motion altogether, one switch in Behavior turns off every window animation at once, and KiwiDesk already honors Reduce Motion if that's on in your System Settings.

How do I uninstall it?

Quit KiwiDesk from its menu-bar icon and remove the app like any other. If you installed it with Homebrew, run brew uninstall --cask kiwidesk. The moment it's off, your windows behave exactly like normal macOS windows again — free to drag, resize, and overlap. Nothing sticks, and nothing of yours was ever changed.

A quick gut-check

Is KiwiDesk for you?

If you spend even a little of your day dragging windows around, you'll probably feel the difference. A few everyday moments, before and after:

An everyday multitasker

Before

A browser, your messages, music, and a note or two — all stacked on top of each other. You drag one aside to find another, then lose track of where the first one went.

After

Every window takes its own spot the moment it opens, nothing buried. You can even send apps to their own space — mail on one, music tucked in a corner — so each one is right where you expect it, every time.

Someone in back-to-back calls

Before

The call window buries your notes. You scramble to find them, then lose the call behind something else.

After

Notes stay visible right beside the call — and you can give your meetings their own space, so the moment a call starts, everything's already in place. You stay present instead of shuffling windows.

A consultant, spreadsheets everywhere

Before

Spreadsheets, a slide deck, a dozen browser tabs, and a call — spread across two monitors, and the first ten minutes of every meeting go to dragging it all into place.

After

Each screen keeps its own tidy layout, and you can pin a space to a monitor — the numbers on one, the deck and the call on the other. Dock or undock and it re-settles on its own. Everything right where you left it.

A writer juggling research

Before

Notes, three browser tabs pulled out into windows, and the draft — all overlapping. Half your time goes to hunting for the window you just had.

After

The draft sits front and center, sources lined up beside it. And when you need a reference that lives on another space, you flick straight there and back in a keystroke — no swiping through desktops, no losing your place.

A designer with many panels

Before

Canvas, layers, an inspector, a reference image — a dozen floating panels you nudge into place at the start of every session.

After

Everything snaps into a balanced arrangement the moment you open it. More screen for the work, less for the fiddling.

A developer juggling terminals

Before

Editor, two or three terminals, a browser full of docs, your git client — the same layout you rebuild by hand every time you sit down.

After

It all tiles itself, flat — no i3-style container nesting to babysit — and rules send each app to its space: code here, chat there. You already knew you wanted this; KiwiDesk just does it and gets out of the way.

Ready to give your screen some peace?

Head back and grab KiwiDesk — it takes about a minute, and your windows will thank you.

Get KiwiDesk