ConfigOption

Canonical dotted identifier used by config get.

Also used as the stable display key.

Human-readable grouping for config.

One-line description of what the option controls.

How env/TOML values are coerced to a typed value.

Typed default value, or None when there is no static default.

Primary environment variable name the loader reads, or None.

For provider credentials this is the canonical name; the DEEPAGENTS_CODE_ prefix override is applied dynamically at resolution time.

Secondary env vars read (in order) when env_var is unset.

Read literally — no DEEPAGENTS_CODE_ prefix logic — so config/config get mirror runtime fallbacks such as get_langsmith_project_name reading bare LANGSMITH_PROJECT.

Section/key path within config.toml, or None.

Whether a TOML bool should be negated after validation.

Representative CLI flag that sets the option, or None.

Whether config reports only set/not-set, never the raw value.

Named redacted rather than secret so the value (and the JSON field it populates) carries no credential-suggesting identifier — the flag is boolean metadata, and a secret-named value tripped CodeQL's clear-text logging heuristic when written to stdout.

Name of the Settings attribute this option backs, or None.

None means the option is read elsewhere inline or is descriptive.

Import module required to use the option, or None.

None means the option is always available or descriptive only.

Optional deepagents-code[...] extra that provides dependency_module.

Provider/service name a credential option authenticates, or None.

Set only for Credentials-group options (e.g. "anthropic", "tavily"), where it is the key /auth stores the credential under and the name passed to model_config.is_service. Carrying it as a structured field lets config/config get look up the stored credential without re-parsing it out of key. None for every other option.

Whether an explicitly present empty env value disables a bool option.

Human-readable type label derived from kind.

Render toml_keys as a [section].key display string.