rooms README

The project's README from github.com/saragordic/rooms. As one markdown file: README.md.

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.

The Rooms switcher over a tidy desk, listing four rooms: Design, Build, Deep Work and Morning

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:

brew trust saragordic/tap
brew install --cask saragordic/tap/rooms

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

Nothing closes

Windows that aren't in the room are hidden, or parked just off-screen when they belong to one of the room's apps. Before a window moves, Rooms writes down where it belongs, and only forgets once the window is back. Show Everything in the menu, quitting Rooms, or opening it again after a crash brings parked windows back; one whose app isn't responding stays recorded and comes back on the next try.

Privacy

Rooms works entirely on your Mac. It makes no network connections of any kind: no accounts, no analytics, no updates checked, nothing sent anywhere.

Your rooms live in ~/Library/Application Support/Rooms/rooms.json, which you can read and edit (Edit Rooms… in the menu). Parked windows are recorded next to it in resting.json, and a log of what Rooms moved stays in ~/Library/Logs/Rooms/rooms.log. These include window titles, so please don't post them unedited in an issue.

A little work in progress

I built this on my Mac and use it all day, but there are still rough edges:

It's built for macOS 14 or later, on Apple Silicon and Intel. I've tested it on Apple Silicon with macOS 26; older macOS versions and Intel Macs haven't had the same hands-on testing.

If something looks wrong, open an issue and tell me your macOS version, Mac model, and whether you're using another screen. Reproduction steps help a lot.

Build it yourself

You'll need Xcode 16 or later (or its Command Line Tools: xcode-select --install).

git clone https://github.com/saragordic/rooms.git
cd rooms
make run

This builds build/Rooms.app and opens it. To keep the Accessibility permission across rebuilds, create a certificate named Rooms Dev in Keychain Access (Certificate Assistant → Create a Certificate → type "Code Signing"); the Makefile uses it when it exists.

Taking it off

Choose Quit Rooms from the menu first: parked windows come back as it quits. Then, if you installed it with Homebrew:

brew uninstall --zap --cask rooms

--zap also removes your rooms and settings. Leave it off to keep them for later.

If you installed it by hand, drag Rooms.app to the Trash, then delete these if you want everything gone:

~/Library/Application Support/Rooms
~/Library/Logs/Rooms
~/Library/Preferences/com.saragordic.rooms.plist

macOS remembers the Accessibility permission separately, so remove Rooms from System Settings → Privacy & Security → Accessibility too.

Contributing

make test      # run the tests for the layout engine
make release   # build the universal Rooms.app and its ZIP

See CONTRIBUTING.md for more details.

License

MIT. See LICENSE.

rooms (saragordic/rooms)

Searching Database…

391 ·GitHub
Rooms
Что это?Rooms — приложение macOS для переключения между проектами: каждая «комната» — сохранённый набор окон с раскладкой, и одно сочетание клавиш возвращает их все аккуратно разложенными, скрывая всё остальное.
Это оконный менеджер или просто лаунчер?Это оконный менеджер, который также управляет раскладкой и переключением окон: он раскладывает окна по схемам вроде Focus, Columns, Grid или Stack, а окна вне активной комнаты паркует или прячет вместо закрытия.
Как установить и настроить Rooms?Установите через Homebrew, скачайте ZIP со страницы Releases и перетащите Rooms.app в Applications или попросите кодинг-агента установить его за вас. Затем откройте окна для проекта, нажмите ⌥Space, назовите комнату, выберите относящиеся к ней окна и нажмите Enter.
Нужно ли что-то особое перед установкой, например Xcode?Для запуска нужны только macOS и Homebrew (или ручная установка из ZIP); Xcode 16 или его Command Line Tools нужны, только если хотите собрать его сами из исходников.
Есть ли шероховатости, о которых стоит знать?Rooms управляет окнами браузера, а не отдельными вкладками; некоторые приложения не сжимаются ниже минимального размера, так что подойти может только раскладка Stack; Spaces и полноэкранные окна не управляются; а Stage Manager конфликтует с ним. Сборка ZIP к тому же не нотаризована, поэтому macOS блокирует первый запуск, пока вы не разрешите его вручную.
Работает ли это на Mac с Intel или только на Apple Silicon?Он поддерживает macOS 14+ и на Apple Silicon, и на Intel, но автор проводил практическое тестирование только на Apple Silicon с macOS 26, так что Intel и старые версии macOS проверены меньше.
Отправляет ли Rooms мои данные куда-либо?Нет. Rooms работает целиком на вашем Mac и никогда не делает сетевых подключений; данные комнат и логи хранятся локально в простых JSON и файлах журналов, которые вы можете читать сами.
Как переключение комнат устроено в повседневной работе?Нажмите ⌥Space, введите или выберите имя комнаты (или используйте ⌃⌥1-9), и Rooms принесёт окна этой комнаты на текущий экран в сохранённой раскладке, пряча или паркуя всё остальное.
Можно ли менять раскладку окон в комнате?Да, нажмите Tab в ⌥Space, чтобы перебирать подходящие под ваш экран раскладки (Focus, Columns, Grid, My Layout, Stack), или разложите окна вручную и нажмите ⌘S, чтобы Rooms запомнил именно такое расположение.
Что происходит с окнами, не входящими в активную комнату?Они никогда не закрываются, только прячутся или паркуются чуть за краем экрана; «Show Everything» в меню, выход из Rooms или его повторный запуск после сбоя возвращает их все.
Удаляет ли деинсталляция все мои комнаты и настройки?Если установлено через Homebrew, деинсталляция с --zap удалит и ваши комнаты, и настройки; без этого флага или при ручном перетаскивании Rooms.app в Корзину они сохранятся на будущее.
What are similar projects?macos-sysdata, tendedero, DockDoor, vorssaint-utils, OpenYoink, dimble, BetterDisplay, boring.notch
Which topics is it in?window-management, menubar-app, window-manager, menubar, menu-bar, xcode, homebrew, macos-app, apple-silicon, swift, offline, utility
Creator
saragordic
Size
0.4 MB
Stars
391
Updated
CommitSep 26Releasev1.0.1Sep 23
Age
26d
Commits · 90 Days