saragordic / rooms

# Rooms
A little Mac app I made for switching between projects.
Every project is a **room**: a set of windows and a layout. Press **⌥Space**, type the
room's name, and your windows come back, laid out neatly. Everything else hides, and
nothing is ever closed.
https://github.com/user-attachments/assets/70a207a0-72cd-42fc-9d75-8060b9c94516
See Rooms in action on X →
## Get it
You can just send this repo to your coding agent and ask it to install Rooms for you:
> Install Rooms on my Mac: https://github.com/saragordic/rooms
Or install it yourself with Homebrew:
 [code] 
Then open **Rooms** from your Applications folder. It lives in the menu bar.
You can also grab the latest ZIP from Releases, unzip it, and drag **Rooms.app** into Applications. The app isn't notarized by Apple yet, so macOS blocks the first launch of the ZIP version: open **System Settings → Privacy & Security → Open Anyway** after trying to launch it. Apple's instructions explain this step. (The Homebrew version opens straight away.)
Rooms needs **Accessibility** access to move windows. Turn it on in **System Settings → Privacy & Security → Accessibility** when it asks. After an update, macOS may ask again: remove Rooms from that list and add it back.
## Make your first room
1. Open the windows a project needs.
2. Press **⌥Space**, type a name for the room, and press Enter.
3. Click the windows that belong in it. The number on a card is its place in the layout, and 1 is the main window. Then **Create Room**.
4. **Press Tab to change the layout.** In ⌥Space, select the room and press Tab (⇧Tab goes back): the preview shows each layout that fits your screen, and the room remembers the one you pick.
The windows come to the screen you're on and lay themselves out. From then on, ⌥Space and the room's name (or ⌃⌥1–9) brings it back. **Getting Started** in the menu shows these steps again.
## Around the rooms
- **Layouts.** In ⌥Space, press **Tab** to try the layouts that fit this screen: Focus (one big window beside the rest), Columns, Grid, **My Layout** (your own arrangement, snapped to a grid with even gaps), or Stack (cards with their title bars peeking out, only when nothing tidier fits). The preview glides as you go.
- **Change which window goes where.** Tab picks the layout; the order decides which window takes which spot, and 1 is the big main spot. To rearrange, right-click the room in ⌥Space and choose **Edit Windows…**: click a card to take it out, click it again to put it back at the end, until the numbers are in the order you want. Or arrange the windows by hand (the ⌃⌥ snapping keys help) and press **⌘S** in ⌥Space to keep that arrangement.
- **Auto fits the screen.** It tries Focus, Columns and Grid, and stacks only when apps' minimum sizes leave no tidy option. When you save a room, Rooms measures how small each app lets its windows get, so layouts fit from the start. Your laptop and your monitor each remember their own layout, and plugging a monitor in re-lays out the room