An auto tiler for macOS
3.1 kB · 62 lines
Markdown
at main

Layout memory #

Parcel remembers layout, count, ratio, gaps, reserved edges, tile dividers, and window stacks for each display UUID and native Space. The versioned JSON store lives in ~/Library/Application Support/dev.vinnymac.parcel/workspace-state.json. Writes are atomic and private to the current user (0700 directory, 0600 file). Unreadable or unsupported data is reported and never overwritten.

#:schema https://tangled.org/vinnymac.dev/parcel/raw/main/docs/parcel.schema.json
[memory]
enabled = true
restore-windows = true

Remembered settings win at launch. A later configuration change or user edit wins over pending restoration. Placement matching lasts at most 10 seconds after launch or a display/Space arrival. Each matched window is placed once; later title changes do not remap it. New windows use normal insertion once restoration ends. Parcel never creates Spaces, transfers windows between Spaces, or launches applications to restore a layout. Missing windows do not prevent current layout changes from being saved.

Windows match by app, role, display, Space, and normalized title hash. A changed title can match only a unique window of that identity. Ambiguous and untitled windows are left alone. Disconnected display and inactive Space records expire after 30 days; the store retains at most 128 workspace records. Native Space IDs can be reused, so a recent record may match a different Space with a reused ID. Forget remembered layouts if that happens.

Title privacy #

Version 3 stores titleDigest hashes, never readable titles or process IDs. Each hash is HMAC-SHA256 of the normalized title, using a random 32-byte key (titleSalt) kept in the same user-only file. Inspect shows the title hashes. Hashes are not encryption: anyone with the file and key can test guessed titles. Keep the file private, including copies you share or back up. Version 2 titles are hashed on load; the next successful save writes version 3 without raw titles. Preserved unreadable files may still contain old readable titles.

Inspect or forget the store in Settings → Layout. From the terminal:

prcl memory inspect --json
prcl memory save
prcl memory reset
prcl undo

Changes save automatically after they settle, not during a drag. memory save flushes pending changes immediately, and quitting flushes them before shutdown. Forgetting readable layouts deletes the store without moving open windows. Corrupt or newer-version files are renamed beside it as workspace-state.<timestamp>.unreadable.json instead of deleted. Settings shows the actual read error and, after recovery, the preserved file's path. The CLI reports the path too. New layout changes begin a fresh memory; preserved files remain until you remove them yourself.

Undo keeps up to 32 actions per window for the current session; coupled tile edits are undone together and a drag is one action. If membership or placement has since changed, Parcel reports the conflict instead of guessing. The default undo shortcut uses the configured prefix plus U.