Configuration essentials
Find settings layers, save scopes, and the full configuration reference.
Prefer the Settings Center
Use /settings, desktop Settings, or:
clio-coder configure --settings
The same groups cover connections, chat, workers, context, permissions, appearance, integrations, and diagnostics. The guided controls help you select a discovered model instead of typing a model ID. See Connect a model for the walkthrough.
Know where a change is saved
| Layer | File or scope |
|---|---|
| User defaults | settings.yaml in Clio's configuration directory |
| Shared project settings | .clio-coder/settings.yaml |
| Local project settings | .clio-coder/settings.local.yaml |
| Active session | The session/project/global choices offered by supported terminal controls |
Find the resolved locations on your machine:
clio-coder paths --json
Objects merge by key; arrays and scalars replace the lower layer. Credential-bearing keys in project settings are ignored. Project saves require trusted project settings.
Saved routes seed a new session. A settings write from another process does not redirect a conversation already running; use that session's model controls.
Look up an exact key
The full reference covers supported settings keys, defaults, CLI flags, project file ownership, and MCP trust. Use Read the full guide above or ask Clio to retrieve the relevant bundled documentation before editing YAML.
Settings validation is strict. For an older installation, clio-coder upgrade applies the registered migration and preserves a version-1 backup. For connection and installation diagnostics, use doctor.