Storage and privacy

Default root:

~/.ctx/
  work.sqlite
  config.toml
  logs/

CTX_DATA_ROOT or --data-root can point ctx somewhere else. The configured root is used directly.

What SQLite stores

The SQLite store may contain provider metadata, source paths, session IDs, event IDs, timestamps, working directories, normalized message and event text, bounded tool-output previews, searchable text, citations, and import cursors when available.

If text is searchable, assume a copy or normalized form exists in SQLite. Treat the ctx data root like private source history.

Provider-owned data

ctx does not own provider homes. Import reads configured or discovered locations and records enough information to search and cite imported material. If a raw provider path moves or is deleted, search can still return indexed text and should mark source availability when that information is known.

Network behavior

Setup, source discovery, import, search, and show are local filesystem and SQLite operations. Search may write newly discovered Codex session history into the local index when --refresh auto or --refresh strict runs. These commands do not repeat whatever network behavior originally produced the provider transcript.