reunite

Snap app windows into a saved grid layout. Run reunite setup once per display to record the layout, then reunite to snap everything back into place.

Installation

npm install -g reunite

Quick start

Open your apps and arrange one window to cover the area you want to use as the grid. Then save the layout:

reunite setup 3x2 --apps Terminal "Google Chrome" Code

After that, run reunite at any time to snap all three apps' windows back into a 3-column × 2-row grid.

Commands

reunite [layout]

Snaps windows into the saved grid for the current display. Pass a layout override to use a different grid without saving it.

reunite          # use saved layout
reunite 2x2      # override grid on the fly
reunite --fill   # fill empty slots with new Terminal windows (macOS only)

reunite setup [layout]

Saves a grid layout for the current display. Reads the position and size of the first window in --apps (or Terminal if omitted) to establish the grid area, then saves the layout to ~/.config/reunite/configs.json.

reunite setup              # 3×2 grid, all visible apps
reunite setup 4x3          # custom grid size
reunite setup --apps Terminal "Google Chrome" Code
reunite setup --activate   # bring windows to foreground on reunite

| Flag | Description | |------|-------------| | --apps app1 app2 ... | Apps to include (default: all visible windows) | | --activate | Bring windows to the foreground on each reunite | | --no-activate | Leave focus alone (default) |

reunite new [scripts...]

Opens one or more new Terminal windows, each placed in the next available grid slot. Optionally runs a shell command in each. macOS only.

reunite new
reunite new "npm run dev" "npm run test"

Platform support

| Feature | macOS | Linux (X11) | |---------|-------|-------------| | Snap existing windows | ✓ | ✓ | | Multi-app targeting | ✓ | ✓ | | --fill / new (open Terminal windows) | ✓ | — | | Wayland | — | — |

Linux setup

Install wmctrl and xrandr:

# Debian / Ubuntu
sudo apt install wmctrl x11-xserver-utils

# Fedora
sudo dnf install wmctrl xorg-x11-server-utils

# Arch
sudo pacman -S wmctrl xorg-xrandr

App names on Linux use the WM_CLASS (the process/class name), not the display name. Common mappings:

| App | macOS name | Linux name | |-----|-----------|------------| | Terminal | Terminal | gnome-terminal, alacritty, xterm | | Chrome | Google Chrome | google-chrome | | VS Code | Code | code | | Firefox | Firefox | firefox |

# Linux example
reunite setup 3x2 --apps alacritty google-chrome code

Config

Layouts are stored in ~/.config/reunite/configs.json — one entry per display. You can edit the file directly to adjust columns, rows, bounds, or the app list without re-running setup.

[
  {
    "display": [0, 0, 2560, 1440],
    "columns": 3,
    "rows": 2,
    "apps": ["Terminal", "Google Chrome", "Code"],
    "bounds": [0, 38, 2560, 1440],
    "size": [2560, 1402],
    "activate": false
  }
]

Requirements

Node 20 or later. On Linux, wmctrl and xrandr must be installed and an X11 session must be active.

License

ISC