Parcel app icon

Parcel

Windows that find their place

Install · Build it yourself · Docs

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).