Files and directoriesΒΆ

All persistent state follows the XDG Base Directory Specification. Override locations with $XDG_CONFIG_HOME and $XDG_DATA_HOME.

Common defaults:

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)