Skip to content

Tatami

v1.0.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ 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 summary

Updates 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.log for 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 / balance hotkeys 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 fresh tiling-memory mode — it rebuilt layouts from a focus-dependent order and reshuffled them on every workspace switch. Workspaces now use session (default) or persistent; existing configs set to "fresh" fall back to session.

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

Track Tatami

Get notified when new releases ship.

Sign up free

About Tatami

All releases →

Related context

Earlier breaking changes

  • v1.3.3 `[[floatingApps]]` renamed to `[[sharedApps]]`; configs migrate automatically.
  • v1.3.2 `[[floatingApps]]` config key renamed to `[[sharedApps]]`; configs migrate automatically on first launch.

Beta — feedback welcome: [email protected]