- Swift 97%
- Shell 3%
- Makefile <1%
- Ruby <1%
- C <1%
Parcel is a native tiling window manager for your Mac. Pick a layout and let windows settle into place as they open, with extra windows tucked into stacks.
Everything is a keystroke away, and every keystroke is yours to change. Parcel works on macOS’s own Spaces and needs only Accessibility permission.
Highlights #
- Seven layouts, with a separate choice for portrait displays.
- A tile cap with stacks: choose your count, then cycle through extra windows with your shortcuts or Tab View.
- Snap, swap, undo: rearrange your windows, then take a step back if you like.
- Focus, No Peek, and Clean Space: make room for the window at hand, dim distractions, or conceal clutter.
- Tab View: find and switch between tiled, floating, and minimized windows.
- Setups: save a collection of apps and bring it back later.
- The hover bar: discover window actions and their shortcuts at the grip.
- Activity: see local counts and discover features you haven’t tried yet.
- Layout memory for each display and Space, across restarts.
- Window rules for apps and windows you’d rather leave floating.
- A little spring in its step, with a motion off switch. Reduce Motion always wins.
- Accessibility first: VoiceOver labels, keyboard controls, Increase Contrast, and Reduce Transparency.
- Shortcuts that fit you, with rebinding, unbinding, and conflict warnings.
- A short guided setup: choose automatic or manual arrangement, with no shortcuts to learn.
- Plain-text config and scripting: live TOML reloads, the
prclCLI, events, and callbacks.
Install #
Requires macOS 15 or later.
Version 0.1.0-beta.1 supports Apple silicon and Intel Macs. This preview is not notarized yet. macOS may require Open Anyway on first launch. Automatic updates are off in this beta.
You can also build it yourself or browse the release tags. There’s no installable Homebrew cask yet.
Our home for source and issues is tangled.org/vinnymac.dev/parcel.
First setup takes three screens: Welcome → Allow Parcel → Ready. Enable Parcel in System Settings → Privacy & Security → Accessibility when prompted. Windows stay put until you choose Tidy my workspace. Automatic setup arranges that workspace, then keeps windows arranged across your screens.
Prefer manual control? Choose Manual on Welcome, then Finish setup without moving windows. Use Retile in the menu whenever you want an arrangement. Set up later leaves Automatic tiling off and remembers your place. Incomplete setup reopens when Parcel launches. Choose Continue Setup… in the Parcel menu to bring the tour forward; the action disappears once setup is complete and no recovery is needed.
Getting around #
Choose grid, columns, rows, side, tree, BSP, or accordion from the menu bar. Windows glide; the chrome gets the bounce.
Set a tile cap in the menu. Use your stack-next shortcut or Tab View to bring extra windows forward. Window controls appear on demand; optional persistent controls use existing gaps without shrinking windows.
Snap to a half or make a tiled window primary. Undo steps back through the focused window’s edits.
Shortcuts #
Shortcuts are optional. More → Keyboard Shortcuts… opens Settings → Shortcuts for learning, rebinding, and conflict warnings. Change the default Control–Option (⌃⌥) prefix in Settings → General.
| Action | Shortcut |
|---|---|
| Swap left / right / up / down | ⌃⌥← / ⌃⌥→ / ⌃⌥↑ / ⌃⌥↓ |
| Focus left / right / up / down | ⌃⌥⇧← / ⌃⌥⇧→ / ⌃⌥⇧↑ / ⌃⌥⇧↓ |
| Make primary | ⌃⌥Return |
| Next / previous window | ⌃⌥] / ⌃⌥[ |
| Stack / unstack | ⌃⌥Space / ⌃⌥; |
| Next / previous stack member | ⌃⌥</kbd> / ⌃⌥⇧<kbd> |
| Grow / shrink / reset sizes | ⌃⌥= / ⌃⌥− / ⌃⌥0 |
| Float / tile; always float | ⌃⌥F / ⌃⌥⇧F |
| Focus / No Peek / Clean Space | ⌃⌥Z / ⌃⌥D / ⌃⌥P |
| Automatic tiling | ⌃⌥T |
| Retile | ⌃⌥R |
| Window cap 1 / 2 / 3 / 4 / 5 | ⌃⌥⌘1 / ⌃⌥⌘2 / ⌃⌥⌘3 / ⌃⌥⌘4 / ⌃⌥⌘5 |
| Snap left / right / top / bottom half | ⌃⌥6 / ⌃⌥7 / ⌃⌥8 / ⌃⌥9 |
| Undo / undo last rule | ⌃⌥U / ⌃⌥F17 |
| Close / fullscreen / hover focus | ⌃⌥Delete / ⌃⌥M / ⌃⌥I |
| Tab View | ⌥Tab |
See the configuration guide for all defaults and prefix changes.
Make it yours #
Settings and ~/.config/parcel/parcel.toml share preferences. Save to reload; bad edits show a line and column, not a surprise layout.
#:schema https://tangled.org/vinnymac.dev/parcel/raw/main/docs/parcel.schema.json
[layout]
default = "grid"
portrait-layout = "rows"
window-cap = 3
when-full = "stack"
gaps = { inner = 8, outer = 8 }
[motion]
enabled = true
[keybindings]
focus-left = "hyper-h"
stack = false
See the configuration guide and editor schema.
Command line #
Use prcl with the running app. It’s bundled in Parcel.app/Contents/Resources/bin.
prcl query windows --json
prcl layout side
prcl focus left
prcl undo
prcl subscribe --json
More in the CLI guide and callbacks guide.
FAQ #
Why does it need Accessibility? Is Screen Recording required? #
Accessibility lets Parcel move and resize windows. Screen Recording is optional, only for pixel captures. You never need to disable SIP.
It isn’t moving my windows. What should I check? #
Check the Accessibility grant; try toggling it off and on. prcl diagnostics helps. Tiling pauses while Stage Manager is active.
Why didn’t a window tile? #
Some windows float by default. prcl why <id> explains one from prcl query windows; rules let you change that choice.
Does it work with Spaces? #
Yes, with separate layouts per display and Space. There are no virtual workspaces; Space commands use Mission Control shortcuts.
Can I turn animations off? #
Yes: Settings → Motion, or [motion] enabled = false. Reduce Motion always wins.
What does it remember about my windows? #
Layouts and placements, with salted title hashes rather than readable titles. Hashes aren’t encryption; see layout memory and privacy.
Can I help translate it? #
Yes. User-facing strings live in String Catalogs; see contributing translations.
Is it ready? #
It’s pre-release. Settings may change without migration. Tell us what needs care.
Build it yourself #
Requires macOS 15+, Xcode 26.3 (see .xcode-version), and mise.
git clone https://tangled.org/vinnymac.dev/parcel && cd parcel
mise trust && mise run setup
Scripts/make-dev-cert.sh
mise run app
Open build/Parcel.app and grant Accessibility. The one-time certificate keeps that grant across rebuilds.
For developers #
- Contributing: setup, tests, and releases
- Architecture and engineering rules
- Configuration and schema · CLI and IPC
- Layout memory · Window rules · Callbacks
License #
Free and open source under Apache-2.0. Third-party notices are in NOTICE.