Tatami

What's new in 0.1.1

• Software updates now work end to end. Sparkle is fully wired up — Tatami checks for and installs updates in the background. Pick the frequency (hourly / daily / weekly) or check manually from Settings or the menu bar. (0.1.0 shipped the appcast but didn't actually wire the updater.)
• New About tab — version, creator, and open-source credits (FlashSpace, yabai, and the libraries Tatami is built with).
• Under the hood: settings now use Perception's observation, dependency clients adopt @DependencyClient, and an unused autoFocusBlacklist setting was removed.

Tatami is a macOS workspace manager with yabai-style window tiling — group your apps into virtual workspaces you switch with a keystroke or trackpad swipe, and have their windows tiled automatically. No SIP changes, no shell scripting.

Features

Tiling (yabai-style BSP)

• Automatic binary space partitioning with a dwindle (spiral) layout
• Directional focus / swap / resize (vim-like h j k l)
• Zoom a window to fill the workspace, toggle split orientation
• Rotate, mirror, balance; drag-to-swap and live resize sync
• Configurable inner / outer gaps

Workspaces

• Per-workspace app assignments; switch by hotkey, swipe, or "recent"
• Loop-around, skip-empty, and follow-app-focus options
• Auto-open assigned apps on activation
• Multi-display (pin a workspace or follow apps dynamically)
• Floating apps that never tile

Focus & interface

• focus-follows-mouse / mouse-follows-focus, optional cursor hide
• Menu bar item with the active workspace (icon + name)
• On-screen HUD on switch, per-workspace SF Symbol icons
• skhd-style shortcut syntax, plain-TOML config, scripting CLI

Install

brew install --cask pangmo5/tap/tatami

Or download the signed & notarized .dmg below.

Requirements

• macOS 14.0 or later
• Accessibility permission (System Settings → Privacy & Security → Accessibility)

See docs/CONFIGURATION.md for the full config.toml reference.

Inspired by FlashSpace and yabai. Licensed under GPL-3.0.