Case file CF-003

mesa

active

A calm macOS window-layout system on Hammerspoon. Floating-first, meeting-aware, and it manages nothing until asked.

Opened
August 2026
Language
Lua
Built with
Claude, as my pair

The idea

Floating-first: mesa manages nothing on its own. It snaps windows into a handful of deliberate arrangements when you ask, and rearranges automatically for meetings.

Think one, two, many, plus one three-pane working shape at two widths, and an automatic meeting mode. Everything is app-agnostic, reflows with the number of windows, and adapts to whichever screen you’re on (laptop, desk, ultrawide).

Layouts

LayoutWhat it does
focusOne app, centred
zenThe same, as a narrow centred column. Most of the screen goes back to wallpaper
splitTwo panes; everything else folds into a stack behind the left one
meeting shapeThe live meeting top-left, chat below, the focused app big on the right
control roomThe same three panes, right pane widened for reading. Only the divider moves
gridEvery app in a balanced grid
meetingFires on a Zoom or Teams meeting or a Slack huddle, and reverts when the call ends

A hint, not the truth

Split remembers a session so it can cycle windows through the stack, but the remembered session is a hint, not the truth. Every press re-resolves it against the live windows, so a stale session decays back into the plain split rather than getting stuck.

The cheatsheet renders from the same table that does the key binding, so it can’t go stale.

← All case files