Module paths 

Per-OS application directories, following the XDG Base Directory spec on every platform — including macOS, so configuration lives at the familiar ~/.config/openlogi/ rather than macOS’s ~/Library/Application Support/.

kind	env override	default
config	$XDG_CONFIG_HOME	~/.config/openlogi
data	$XDG_DATA_HOME	~/.local/share/openlogi

On Windows $HOME falls back to %USERPROFILE%, so paths resolve to %USERPROFILE%\.config\openlogi etc.

Decision (#347): the Windows location is final, not best-effort. XDG-on-every-platform is this module’s deliberate design — macOS also skips its native ~/Library/Application Support — and Windows follows the same rule rather than %APPDATA%. Recorded before the agent first shipped in Windows artifacts, because moving it afterwards would strand every existing user’s config.toml and the agent’s first-run state. Local packaged macOS builds stamped with .dev bundle identifiers use the same layout under an openlogi-dev app directory.

Enums

PathsError

Failure resolving the per-user base directories.

Functions

agent_socket_path

Path to the background agent’s Unix-domain IPC socket: the GUI connects here to reach the agent that owns device I/O.

config_dir

Directory holding the user’s config.toml.

config_path

Full path to the user config file.

data_dir

Directory for downloaded application data; the device-render asset cache lives under data_dir()/assets.

home_dir

The current user’s home directory.

runtime_dir

Directory for runtime sockets — the background agent’s IPC endpoint.

xdg_config_home

The raw XDG config home directory (without the openlogi subdirectory).