Files and directories
=====================

All persistent state follows the `XDG Base Directory Specification
<https://specifications.freedesktop.org/basedir-spec/latest/>`_.  Override
locations with ``$XDG_CONFIG_HOME`` and ``$XDG_DATA_HOME``.

Common defaults:

.. list-table::
   :header-rows: 1

   * - Variable
     - Linux
     - macOS
     - Windows
   * - ``$XDG_CONFIG_HOME``
     - ``~/.config``
     - ``~/Library/Application Support``
     - ``%APPDATA%``
   * - ``$XDG_DATA_HOME``
     - ``~/.local/share``
     - ``~/Library/Application Support``
     - ``%LOCALAPPDATA%``

``$XDG_CONFIG_HOME/telix/`` contains per-feature configuration:

- ``sessions.json``
- ``triggers.json``
- ``macros.json``
- ``highlights.json``
- ``progressbars.json`` - progress bar toolbar configuration

``$XDG_DATA_HOME/telix/`` contains per-session data using a SHA-256 slug
of ``host:port``:

- ``history-<hash>`` - command history
- ``rooms-<hash>.db`` - SQLite room graph (GMCP Room.Info)
- ``chat-<hash>.json`` - GMCP Comm.Channel.Text history
- ``gmcp-<hash>.json`` - rolling GMCP data snapshot with per-package timestamps
- ``prefs-<hash>.json`` - per-session runtime preferences
- ``.current-room-<hash>`` - current room number (read by the room browser)
- ``.fasttravel-<hash>`` - queued fast-travel steps (written by the room browser, read by the REPL)