Configuration

CtxE configuration is currently managed automatically by the install script. Running the installer sets up a working config with sensible defaults — no manual configuration required.

Under active development

The configuration system is being optimized. Full documentation for manual config options (ignore patterns, embedding tuning, provider settings, etc.) will be available once the format is stabilized.

Config precedence

When config is finalized, the precedence order will be:

  1. Embedded defaults (built into the binary)
  2. Global config — ~/.ctxe/config.toml
  3. Workspace config — .ctxe.toml in project root
  4. Environment variables (highest priority)

Useful commands

# Show where config files are located
ctxe config path

# Show active (merged) configuration (secrets redacted)
ctxe config show

# Create default config at ~/.ctxe/config.toml
ctxe config init