A niri-style scrollable-tiling window manager for macOS, written in Odin. Windows live in a horizontal strip of columns you scroll through, instead of a grid that reshuffles every time you open something. It moves real windows through the public Accessibility API, with no SIP changes. The only private API it touches is _AXUIElementGetWindow (long stable, also used by yabai) to map an AX window to its CGWindowID for ScreenCaptureKit.

Needs the Odin compiler (brew install odin), the Xcode command-line tools, and just (brew install just) as the task runner.

just build          # compiles the AppKit shim + the Odin app -> ./wm
just check          # type-check without producing a binary
just test           # run the pure layout unit tests
just --list         # see all recipes

just build just runs ./build.sh, so you can call that directly if you'd rather not install just.

• WM_CODESIGN_ID (optional): an Apple Development: ... signing identity used to sign ./wm after each build. macOS ties Accessibility / Input Monitoring grants to the signature, and ad-hoc signatures change every build (revoking the grants), so setting a stable identity means you only grant the permissions once. Find yours with security find-identity -p codesigning; leave it unset to skip signing.

  WM_CODESIGN_ID="Apple Development: you@example.com (TEAMID)" just build

just daemon         # run the daemon in the foreground; starts tiling immediately
./wm daemon Safari  # manage only one app (safe for a live test next to your current WM)
just daemon-bg      # run detached (survives closing the terminal); logs to /tmp/niri-mac.log
just logs           # follow the detached/service daemon's output

To have it start at login, just service-install writes a LaunchAgent (remove it with just service-uninstall). Under launchd the daemon runs as the wm binary itself, so grant wm (not your terminal) the two permissions.

Grant the two permissions macOS prompts for on first run (both under System Settings > Privacy & Security):

• Accessibility: to move and resize windows.
• Input Monitoring: for the global hotkeys.

Grant them to whatever runs wm (your terminal in development, or the wm binary itself when run headless). Disable any other window manager first or they'll fight. Pause tiling any time with Alt+T (or wm live off); stop the daemon and restore windows with wm stop. Run wm help for the full list of CLI commands.

The modifier is Alt (Option).