mimi

Who It's For

mimi is for developers who want yabai-style scriptable window and Spaces control but don't want to touch SIP. Because every action is a plain shell command, it suits people who already drive their Mac from skhd, Raycast, Alfred, Karabiner, Hammerspoon, or BetterTouchTool and want a single CLI they can bind to any of those tools. It's explicitly early-stage software — the project itself warns that "config keys, CLI flags and behaviour may still change between releases" — so it fits users comfortable tracking a fast-moving tool rather than those who need a stable, finished product.

How It Works

mimi's actions work standalone, without the daemon: space navigation, moving windows across spaces and displays, resizing to presets like halves, thirds, and quadrants, directional window focus, and closing, minimizing, or fullscreening a window are all plain CLI calls, and query commands return the desktop's state — spaces, windows, displays — as JSON. Running the background daemon unlocks the rest: hooks that fire shell commands on app, window, and space events; colored border outlines around focused versus unfocused windows; a menu bar indicator showing the active space and config reload status; and optional auto-tiling driven by layout programs written in Python. Under the hood, mimi uses Objective-C bridges inside its Go codebase — space switching goes through synthetic dock swipes via CGEvent, moving windows between spaces uses private SkyLight APIs, and everything else runs on the public Accessibility framework, which is why it needs only Accessibility permission and no SIP changes.

Configuration

Configuration lives in a single TOML file. Hooks, for example, can filter by application, bundle ID, window title, or space number:

# ~/.config/mimi/config.toml
[hooks]
  { run = "command-here", space = 2 },
]

Custom tiling layouts are separate Python files referenced from a directory such as ~/.config/mimi/tiling/; six example layouts — monocle, columns, master-stack, a BSP-style dwindle, a stacked arrangement, and a scrollable strip — ship as starting points, written in Python with the standard library only.

Compared to Alternatives

Compared to yabai, which needs a partial SIP disable for some of its window-management features, mimi is built to leave SIP untouched entirely, trading some of yabai's deeper window-layer control for a simpler permissions story. Compared to AeroSpace, which replaces macOS Spaces with its own virtual workspace system, mimi works within native Spaces and switches between them using synthetic dock swipes rather than bypassing them. mimi's tiling is also pluggable rather than fixed — layouts are user-supplied Python scripts instead of a single built-in algorithm.

Requirements

• macOS 14 Sonoma or later (the project pins a macOS 14.0 floor)
• Accessibility permission required; no SIP modifications needed
• Apple Silicon and Intel prebuilt binaries available, or build from source with Go and Xcode Command Line Tools
• Early development — config keys, CLI flags, and behavior may still change between releases

Getting Started

Install with Homebrew: brew tap y3owk1n/tap then brew install --cask y3owk1n/tap/mimi (a Nix flake and prebuilt binaries are also available). Configuration lives at ~/.config/mimi/config.toml; the mimi-setup-config and mimi-setup-layout helper commands can scaffold it for you. From there, bind CLI calls like mimi action space 2 or mimi action focus_window --left to your hotkey tool of choice, and start the daemon to enable hooks, borders, and tiling. See the GitHub repo for full CLI and configuration reference.