Effective Config

Effective config is the runtime view produced by loading global config and overlaying the current project’s local config.

Config Locations

Global config lives at:

• $XDG_CONFIG_HOME/tonic/config.yaml when XDG_CONFIG_HOME is set.
• ~/.config/tonic/config.yaml otherwise.

Local config lives at:

• <repo-root>/.tonic/config.yaml when the current directory is inside a git repository.
• ./.tonic/config.yaml when the current directory is not inside a git repository.

Merge Rules

At runtime, tonic loads global config first and then overlays local config.

• A local connections.<name> entry replaces the global connection with the same name as a whole entry.
• Other top-level sections merge field-by-field.
• inspect_cache.path and inspect_cache.ttl can be overridden independently.
• permissions.allow and permissions.deny can be overridden independently.
• snowflake.browserauth_cache_dir can be set globally or locally.

Missing config files load as empty version: 2 config.

Inspect The Effective View

tonic connections show

The list output shows global and local config paths plus each target’s source.

tonic connections show warehouse

The named output renders the effective connection as YAML and includes its source path. Secret values are not expanded.

Schema Version

The current config shape is version: 2.

version: 1 is rejected. A missing or zero version is treated as the current version.