Overview

The Ingrain CLI reads configuration from one file: your user-level conf.toml. Its path resolves per platform:

• Linux / macOS: $XDG_CONFIG_HOME/ingrain/conf.toml if XDG_CONFIG_HOME is set, otherwise $HOME/.ingrain/conf.toml.
• Windows: %APPDATA%\ingrain\conf.toml.

On top of that:

• Environment variables win. INGRAIN_PROXY_URL overrides the matching [upgrade] key at runtime, and INGRAIN_SYNC_URL / INGRAIN_API_TOKEN override the matching [context] keys. This is the supported way to point a single invocation somewhere else.

Sections

Section	What it configures
[upgrade]	The proxy URL ingrain upgrade pulls from.
[context]	Sync URL + API token for ingrain context and ingrain record.

Finding your conf.toml

ingrain config prints the path to your user-level conf.toml so you can open it in your own editor:

ingrain config

The file is created and seeded with the full annotated reference by install.