Tatami

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

Highlights

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
• Sparkle auto-updates

Install

brew install --cask pangmo5/tap/tatami

Or download Tatami-0.1.0.dmg below (signed & notarized).

Requirements

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

Configuration

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

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