Quickstart

This page installs Lattices. After it, the menu bar app is running and lats works in your terminal. Getting started then walks through tiling, finding windows, and starting a project session.

Requires macOS 26 or later on Apple Silicon. For Hyprland and Omarchy, use Install on Linux.

The current release is 0.15.2. Install the app and CLI at the same version.

1. Install the app

With Homebrew:

brew tap arach/tap
brew trust arach/tap
brew install --cask arach/tap/lattices

Or download the 0.15.2 disk image and drag Lattices.app to /Applications.

2. Install the CLI

The CLI needs Bun at runtime, including when installed with npm.

bun install -g @lattices/lattices

This installs lats, with lattices as a long-form alias. npm install -g @lattices/lattices also works.

Check:

lats help

Expected: the command reference prints. If the shell reports command not found, add Bun's global bin directory to PATH and open a new shell.

One-command setup

On a new Mac, the setup script installs Homebrew when needed, tmux, Bun, and the CLI. Review the installer source before running it:

curl -fsSL https://raw.githubusercontent.com/lattices-dev/lattices/main/install.sh | bash

3. Launch the app

lats app

Expected: the Lattices icon appears in the menu bar and macOS asks for Accessibility access. Grant it; tiling and the command bar need it. When the CLI finds no installed app, lats app builds one from source if Swift is available, or downloads a release.

To open Lattices at login:

lats app install

Next

Continue with Getting started: tile a window with a key, open the command bar, find and place a window from the terminal, and start a session for a project.