# 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. ```toml #: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: ```sh 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..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.