An auto tiler for macOS

Setups #

Save a named arrangement, then reopen it from the menu, Settings, a configurable shortcut, or prcl.

A setup stores bundle IDs, window roles and HMAC title digests, plus each known display–Space workspace's layout, cap, tiles and floating geometry. Raw window titles are never written to the setup file. The title salt is stored beside the digests: this is obfuscation, not encryption. Anyone who can read the file can test guesses for short or predictable titles. Save reuses layout memory's title salt and known inactive snapshots when available; current observations refresh them, and exited apps are excluded on connected displays. Disconnected display records are kept unchanged. Setups live in a versioned, atomic JSON store in Application Support. Corrupt data stays in place with a private backup and a visible notice; repair it before writing again.

Opening launches apps without activating each one. Hide other apps is on by default and can be turned off. Hiding starts only after launched apps' saved windows and destinations are ready. Parcel requests each hide, then confirms visibility asynchronously within 500 ms for the batch; confirmed hidden windows leave tiling immediately. Only ordinary user apps are hidden; system infrastructure and Parcel remain visible. Windows join their saved tiles as they appear. Escape cancels only while the loading notice is key; Cancel opening is also available in the notice and menu. Cancellation, failure or the 20-second deadline restores apps this opening hid and stops waiting for in-flight launches. A launch already accepted by macOS may still finish; cancellation does not quit it.

Saved destinations must be connected, active native Spaces with verified geometry. Parcel does not create Spaces or guess a replacement display. Save includes known inactive workspaces, but windows that have never been observed are not discoverable through a setup.

On screen means the observed arrangement matches. Changed means the opened setup no longer matches. Put Back reopens it. Update is always available, including after relaunch, and asks before replacing the saved arrangement. It keeps disconnected display records and removes exited apps from connected displays, including apps that failed to launch. With hiding off, other managed windows stay in the layout and can prevent an exact match. Settings also provides rename, emoji, shortcut, reordering, and delete with Undo.

Opening records one placement undo for surviving windows, including delayed arrivals. Undo does not quit newly launched apps. Undoing the most recent completed opening's placement restores that opening's hidden apps. Undoing an unrelated operation does not unhide them. Cancellation keeps the partial arrangement with the same placement undo. The existing window-indexed history cannot undo settings-only changes when every affected workspace is empty.

prcl setup list
prcl setup save "Writing" --no-hide
prcl setup open "Writing"
prcl setup delete "Writing"

--json returns structured results. Opening includes native launch receipts; those receipts support strict ownership checks in the reality lane. PARCEL_SETUPS_PATH isolates storage for tests and development.