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.