This release includes 1 breaking change for platform teams planning a safe upgrade.
Published 21d
Developer Productivity
✓ No known CVEs patched
✓ No known CVEs patched in this version
Topics
aerospace
bsp
composable-architecture
flashspace
macos
menu-bar
+8 more
productivity
swift
swiftui
tca
tiling-window-manager
window-manager
workspace-manager
yabai
Summary
AI summaryUpdates New, Removed / config change, and minus across a mixed release.
Full changelog
Tatami 1.0.0 — the first stable release. Here's what changed since v0.1.3.
New
- Drag to rearrange — drag a window and a live overlay previews the drop: the center swaps the two windows, an edge inserts the dragged one on that side (left / right / top / bottom).
- Window markers — a small corner dot marks zoomed / floating windows; configurable color, size, corner, and hover-fade.
- Multi-window zoom and per-workspace layout memory (
session/persistent). - New shortcuts: balance the tree, toggle the focused app's workspace membership; plus a toolbar Activate button.
- Optional debug logging to
~/.config/tatami/tatami.logfor diagnosing tiling.
Improvements
- Manual resize now drags any window edge and re-tiles against the correct join — height resizes work even when the immediate split is vertical; a drag that changes nothing snaps the window back to its tile.
- Manual move / resize commits on mouse-up (not a timer), so dragging stays smooth and never fights you mid-drag.
- Window markers track their windows event-driven (no polling timer) — ~zero idle CPU.
- Reworked concurrency: AX window hit-testing, the CLI socket server, and the mouse / gesture event taps no longer block the main thread or the Swift cooperative pool.
- Snappier focus-follows-mouse and tiling-debounce timings.
- Overhauled BSP insert / swap / warp / balance semantics.
Fixes
grow/shrink/balancehotkeys did nothing in common layouts — fixed.- Gap and dot-size steppers in Settings ran away on a single click — fixed.
- Parse
-(minus) in shortcut strings; resize horizontal splits correctly.
Removed / config change
- Dropped the
freshtiling-memory mode — it rebuilt layouts from a focus-dependent order and reshuffled them on every workspace switch. Workspaces now usesession(default) orpersistent; existing configs set to"fresh"fall back tosession.
Requires macOS 14+ and Accessibility permission. Install with brew install --cask pangmo5/tap/tatami, or download the signed & notarized DMG below.
Breaking Changes
- Removed 'fresh' tiling-memory mode; configs set to "fresh" now fallback to "session".
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Tatami
All releases →Related context
Related tools
Beta — feedback welcome: [email protected]