A small, open window manager for the Mac: snap windows by shortcut or by dragging them to the edge.
One of six free, open-source Mac apps by Ciro Cesar Maciel.
Halves, full screen, center, the next display and sizes of your own, each on a shortcut you can change. Drag a window to an edge or a corner and let go. It lives in the menu bar, with no Dock icon, and it has no network code. In the spirit of Rectangle and Magnet, deliberately smaller. A native Swift app for macOS 14+ on Apple Silicon.
curl -fsSL https://blob.ciromaciel.click/tools/windows/install.sh | bashThe script downloads the latest .dmg, copies Windows to /Applications and opens it.
With Homebrew: brew install --cask ciro-maciel/tap/ciro-windows.
Prefer the disk image? Download Windows-macos.dmg. Open it and drag Windows to Applications. It is signed with Developer ID and notarized by Apple, so macOS opens it with no warning.
On the first run, turn on Windows in System Settings → Privacy & Security → Accessibility. That is the permission macOS requires for an app to move other apps' windows; Windows shows the system prompt, opens its settings, and notices by itself when the permission is on.
| Default shortcut | Where the front window goes |
|---|---|
| ⌃⌥← / ⌃⌥→ | Left / right half |
| ⌃⌥↑ / ⌃⌥↓ | Top / bottom half |
| ⌃⌥↩ | Full screen, without covering the menu bar and the Dock |
| ⌃⌥C | Center, same size |
| ⌃⌥⌫ | Back to the size and place it had before |
| ⌃⌥⌘→ | Next display, same relative place and size |
| ⌥F / ⌥D / ⌥S | The three sizes that ship: 97.1% × 97% centered, 80% at the top, 60% at the top |
- Every shortcut is yours. In Settings, click a shortcut and press the new combination; ⌫ removes it, Esc cancels. "Restore default shortcuts" undoes it all.
- Your own sizes. Name, width and height (a share of the screen or points), a place on a 3 × 3 grid, which display (the window's, the main one, the next one) and a shortcut, with a live preview. Deleting one is a 3-second hold.
- Drag to the edge. Left or right edge, half; top edge, full screen; a corner, a quarter. While the cursor is in a zone, an outline shows where the window will land. It snaps only when the window moved and kept its size, so resizing or selecting text never triggers it. It can be turned off.
- Conflict check. When you record a shortcut, Windows looks for who else uses it: the macOS shortcuts that are on, the menus of every open app (through Accessibility), another window manager that is running, and its own table. A repeat inside Windows is refused; the others are shown in red. A global shortcut of another app is invisible to macOS's public APIs, and the settings say so.
- Shares the Mac with other window managers. It recognizes a running Rectangle, Rectangle Pro, Magnet, Moom and a few others, warns in the menu and in Settings, and takes the shortcuts back as soon as the other one quits.
- Menu bar only. Every position and size is one click away in the menu, and it can open when you log in.
- Swift, AppKit (menu bar, native menu) and SwiftUI (Settings), compiled by
swiftc: no Xcode project, no package manager, no dependencies. - Shortcuts with Carbon's
RegisterEventHotKey. Moving a window goes through the Accessibility API: size, position, size again, withAXEnhancedUserInterfaceturned off during the move. - Dragging uses global mouse monitors.
- No network code: no
URLSession, no sockets. Your shortcuts and sizes are saved in the app's user defaults on this Mac.
You need the Xcode Command Line Tools. Xcode itself is optional.
git clone https://github.com/ciro-maciel/windows.git
cd windows
scripts/build.sh # dist/Windows.app
open dist/Windows.appscripts/build.sh signs with a Developer ID Application certificate when your keychain has one (the official build does), with the hardened runtime. Otherwise run scripts/signing-identity.sh once: it creates a local signing certificate, and with it the Accessibility permission survives each rebuild. Without either, the build is signed ad hoc and macOS asks again every time.
Tests:
dist/Windows.app/Contents/MacOS/Windows --selftest # geometry, sizes, drag zones and shortcuts; moves no window
dist/Windows.app/Contents/MacOS/Windows --conflicts cmd+n # who else uses a combination
scripts/e2e.sh # end to end: real key presses, mouse drags and the menuscripts/e2e.sh opens its own window and uses a separate settings suite, so your settings are never touched. It takes over the mouse and keyboard for about 40 seconds, closes a running Rectangle, Rectangle Pro or Windows for the test and reopens it at the end, and needs Accessibility for the terminal that runs it.
- Apple Silicon and macOS 14 or newer only.
- The interface is in English and Brazilian Portuguese, following the Mac's language.
- Left out on purpose: thirds and size cycling, gaps between windows, saved layouts, trackpad gestures and iCloud sync.
Issues and pull requests are welcome. See CONTRIBUTING.md.
MIT. Fonts and icons keep their own licenses: see NOTICE. Rectangle, Magnet and the other apps named here are products of their own makers; this project is not affiliated with them.
I build software on my own, with a team of AI agents, and open what I can. Six native Mac apps, all free, MIT, signed and notarized by Apple, in English and Brazilian Portuguese: Cleaner, the Mac cleaner that shows you everything before it deletes anything · Screenshots, capture, annotate and record the screen, with nothing leaving your Mac · Speech to Text, dictation by shortcut, with Whisper running on your Mac · Assistant, Claude Code by voice · Windows, snap windows into place with a shortcut or by dragging them to the edge (this one) · Text to Speech, select text in any app and hear it read aloud.
Beyond the apps: free tools for the browser, books, and Infrastructure, the infrastructure AI agents already know how to run.
Follow along. Follow @ciro-maciel for the next open-source apps, click Watch → Custom → Releases above for every new version, and see how it is all made on YouTube and at ciromaciel.click.