KiwiDesk README

The project's README from github.com/KiwiCanopy/KiwiDesk. As one markdown file: README.md.

KiwiDesk

Tiling that feels like it shipped with macOS.

Start simple. Grow without limits. KiwiDesk tiles your windows the moment you install it — no config required. When you want more, go deeper: custom Lua, profiles, advanced layouts, per-space rules. Powerful when you reach for it, never in your way.


macOS 14+ Swift 6 CI License BSL 1.1 Homebrew Release

Website · Docs · Quick Start · Recipes · Changelog · Roadmap · Sponsor

Windows gliding sideways through the scrolling layout as focus moves between them

Why KiwiDesk?

I love tiling window managers, but I could never recommend one to a friend who doesn't live in a terminal. On the Mac they all want a config file first; they feel like a nerd's toy. KiwiDesk is the one I can hand over: it tiles your windows the moment it starts, everything is a slider or a switch in a real Settings window, and going deeper feels like learning a feature rather than hacking a file. When you do want the file, it is there: Lua config, a CLI and a socket, the whole nerd's toy underneath.

It is also built to survive macOS updates. Every private Apple API has a public fallback, and the two things only Apple's own bridge can do switch themselves off after an update instead of breaking.

How it compares with yabai, AeroSpace and the rest →

Installation

Requirements: macOS 14 or later, on Apple silicon.

brew install --cask kiwicanopy/tap/kiwidesk

Or download the .dmg — the same signed, notarized app; the cask additionally puts the kiwidesk CLI on your PATH. Either way KiwiDesk checks for updates itself.

On first launch a wizard walks you through the Accessibility permission, then tiles your windows straight away. Everything past that — Settings, the CLI, Lua — is in the Quick Start.

Building from source

For contributors, or to run an unreleased commit. Requirements: macOS 14+, Xcode 16+ / Swift 6.

git clone https://github.com/KiwiCanopy/KiwiDesk.git
cd KiwiDesk
swift build -c release
.build/release/KiwiDesk           # run the app

Contributing

See CONTRIBUTING.md and AGENTS.md; AI coding agents are welcome. To report a vulnerability, see SECURITY.md.

License

Business Source License 1.1: using KiwiDesk is free, at home and at work; offering, selling, bundling or hosting it or a derivative as a product or service needs a commercial license. Each version becomes MIT four years after publication.


KiwiDesk's source is public. If you like it, leave a ⭐ — it is the one thing that helps other people find it.


A KiwiCanopy project — Because our time is precious 🥝

KiwiDesk (KiwiCanopy/KiwiDesk)

Searching Database…

Что это?KiwiDesk — это тайловый оконный менеджер для macOS, который автоматически раскладывает ваши окна без файла конфигурации и управляется через нативное приложение Settings, но при этом для продвинутых пользователей остаются Lua-конфиг, CLI и сокет.
Это GUI-приложение или для использования нужно править конфиг-файл вручную?Это нативное приложение macOS с настоящим окном Settings — тайлинг, раскладки и правила из коробки настраиваются ползунками и переключателями, и только если хочется пойти глубже, вы трогаете Lua-конфиг, CLI или сокет.
Как установить и запустить?Скачайте подписанный, нотаризованный .dmg или установите через Homebrew cask (он дополнительно добавляет CLI kiwidesk в PATH); при первом запуске мастер проведёт вас через выдачу разрешения Accessibility, после чего тайлинг начнётся сразу.
Что нужно Mac для его работы?macOS 14 или новее на Apple Silicon — Mac на Intel не упоминаются как поддерживаемые. Для самостоятельной сборки из исходников дополнительно нужны Xcode 16+ и Swift 6.
Требует ли он отключения SIP, как некоторые другие тайловые менеджеры?Нет — KiwiDesk запрашивает только разрешение Accessibility и явно спроектирован так, чтобы никогда не требовать отключения System Integrity Protection.
Какие условия лицензии стоит знать?Он распространяется под Business Source License 1.1: бесплатно для личного использования и на работе, но предложение, продажа, встраивание в комплекты или хостинг его (или производной работы) как продукта или сервиса требуют коммерческой лицензии; каждая версия переходит на MIT через четыре года после выпуска.
Сколько раскладок он предлагает?Семь раскладок, включая скроллящуюся раскладку в стиле PaperWM наряду с более традиционными.
Ломает ли переход на KiwiDesk нативные Spaces/рабочие столы macOS?Нет, нативные рабочие столы macOS сохраняются нетронутыми, а не заменяются собственной системой виртуальных столов.
Сломает ли обновление macOS KiwiDesk?Он создан, чтобы переживать обновления: у каждого используемого приватного Apple API есть публичный запасной вариант, а немногие вещи, которые умеет только приватный мост Apple, после обновления просто отключают себя, вместо того чтобы ломать приложение.
Чем он отличается от yabai или AeroSpace?В отличие от yabai он никогда не требует отключения SIP, а в отличие от инструментов, ставящих во главу конфиг-файл, вроде AeroSpace, он раскладывает окна из коробки через GUI-приложение Settings, сохраняя при этом под капотом ту же мощь Lua-конфига и CLI для желающих.
What are similar projects?omacosy, DockDoor, glazewm, rift, Sapphire, rooms, AeroSpace, OpenYoink
Creator
KiwiCanopy
Size
78.7 MB
Stars
174
Age
3mo
Commits · 90 Days