Skip to content

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 27 May 13:33
· 146 commits to main since this release

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.