Advanced

Configuration

Contxt stores its configuration globally in ~/.contxt/. Most settings are managed automatically — this page covers manual configuration options.

Config directory

  • ~/.contxt/db.sqliteLocal database — all memory entries across all projects
  • ~/.contxt/auth.jsonAuthentication credentials (access token, user ID)
  • ~/.contxt/config.jsonGlobal settings (Supabase URL override, default branch)

Environment variables

These environment variables override config file values:

VariableDescription
CONTXT_SUPABASE_URLOverride the Supabase URL (for self-hosting)
CONTXT_SUPABASE_ANON_KEYOverride the Supabase anon key
CONTXT_DB_PATHOverride the SQLite database path

Reset config

To reset authentication without removing your local data:

contxt auth logout

This removes ~/.contxt/auth.json only. Your local database and project registrations are preserved.