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 `prcl` CLI, events, and callbacks.
## Install
*Requires macOS 15 or later.*
[Download Beta](https://tangled.org/vinnymac.dev/parcel/artifacts/3n2k43u5vaku7) · [Checksums](https://tangled.org/vinnymac.dev/parcel/artifacts/3n2k447xvzmu7)
Version 0.1.0-beta.1 supports Apple silicon and Intel Macs. This preview is
not notarized yet. macOS may require [Open Anyway](https://support.apple.com/en-us/102445)
on first launch. Automatic updates are off in this beta.
You can also [build it yourself](#build-it-yourself) or browse the
[release tags](https://tangled.org/vinnymac.dev/parcel/tags). There’s no installable Homebrew cask yet.
Our home for source and issues is [tangled.org/vinnymac.dev/parcel](https://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 | ⌃⌥` / ⌃⌥⇧` |
| 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](docs/configuration.md#shortcuts-and-motion) 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.
```toml
#: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](docs/configuration.md) and [editor schema](docs/parcel.schema.json).
## Command line
Use `prcl` with the running app. It’s bundled in `Parcel.app/Contents/Resources/bin`.
```sh
prcl query windows --json
prcl layout side
prcl focus left
prcl undo
prcl subscribe --json
```
More in the [CLI guide](docs/command-line.md) and [callbacks guide](docs/callbacks.md).
## 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 ` explains one from `prcl query windows`; [rules](docs/window-rules.md) 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](docs/command-line.md#native-spaces) 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](Sources/ParcelEngine/ParcelEngine.docc/LayoutMemory.md).
#### Can I help translate it?
Yes. User-facing strings live in String Catalogs; see [contributing translations](CONTRIBUTING.md#translations).
#### Is it ready?
It’s pre-release. Settings may change without migration. [Tell us what needs care](https://tangled.org/vinnymac.dev/parcel/issues).
## Build it yourself
*Requires macOS 15+, Xcode 26.3 (see [.xcode-version](.xcode-version)), and [mise](https://mise.jdx.dev/).*
```sh
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](CONTRIBUTING.md)
- [Architecture and engineering rules](AGENTS.md)
- [Configuration and schema](docs/configuration.md) · [CLI and IPC](docs/command-line.md)
- [Layout memory](Sources/ParcelEngine/ParcelEngine.docc/LayoutMemory.md) · [Window rules](docs/window-rules.md) · [Callbacks](docs/callbacks.md)
## License
Free and open source under [Apache-2.0](LICENSE). Third-party notices are in [NOTICE](NOTICE).