Preferences storage

The storage module uses $XDG_CONFIG_HOME/among, falling back to $HOME/.config/among when XDG_CONFIG_HOME is absent or empty.

Plugin choices keep the existing plugins.json format:

{"plugins": [{"name": "clock", "enabled": false}]}

Shortcut overrides use shortcuts.json, version 1:

{"version": 1, "overrides": {"split-pane": "<Control><Shift>b", "toggle-zoom": null}}

An absent override inherits the current default; null explicitly removes a binding. Unknown fields and entries are retained when saving other preferences. Malformed files and unsupported versions are not automatically overwritten.

Writes use a private temporary file in the destination directory and atomic replacement. Failures before replacement preserve the prior document; failures confirming directory durability after replacement report uncertainty. Symlink destinations are refused. Independent external edits are merged when detected; simultaneous writes by external editors are not fully serialized.

Changing preferences

Accepted edits in both Preferences pages apply immediately and are saved without a Save button. Fresh launches restore plugin choices and shortcut overrides. Reassigning an occupied shortcut also saves the displaced action as unbound. Cancelled capture and rejected/no-op edits do not write new overrides.

A failed write leaves the edit active for this session and shows a warning in Preferences and a notification. A later edit in the same settings category retries pending changes; successful saving clears that category's warning. Repair malformed files or directory permissions before retrying. Startup errors are visible too. Plugin faults do not change the saved desired enabled state.

Clock, resources and pane PWD remain optional and disabled by default. Only explicit user changes enable them. No terminal contents or workspace layouts are saved here.

Developer checks are described in the contributing guide.