Struct Config 

pub struct Config {

    pub last_used_model: Option<String>,
    pub default_model: ModelSettings,
    pub ollama: OllamaConfig,
    pub web: WebConfig,
    pub ui: UiConfig,
    pub non_interactive: NonInteractiveConfig,
    pub mcp_servers: HashMap<String, McpServerConfig>,
    pub mcp_defer_tools: Option<bool>,
    pub providers: HashMap<String, UserProviderConfig>,
    pub reasoning_per_model: HashMap<String, ReasoningLevel>,
    pub ollama_num_ctx_per_model: HashMap<String, u32>,
    pub model_aliases: HashMap<String, String>,
    pub safety: SafetyConfig,
    pub memory: MemoryConfig,
    pub daemon: DaemonConfig,
    pub compaction: CompactionConfig,
    pub computer_use: ComputerUseConfig,
    pub exec: ExecConfig,
    pub plan: PlanConfig,
    pub agents: AgentsConfig,
    pub prompt: PromptConfig,
    pub active_profile: Option<String>,
}

Main configuration structure

Fields

last_used_model: Option<String>

Last used model (persisted between sessions)

default_model: ModelSettings

Default model configuration

ollama: OllamaConfig

Ollama configuration

web: WebConfig

Web tool (web_search / web_fetch) backend selection.

ui: UiConfig

TUI appearance preferences ([ui] table).

non_interactive: NonInteractiveConfig

Non-interactive mode configuration

mcp_servers: HashMap<String, McpServerConfig>

MCP server configurations

mcp_defer_tools: Option<bool>

When unset or true, MCP tools are DEFERRED: instead of advertising every server’s tools on every request, the model gets one tool_search tool that returns matching schemas and promotes them to direct advertisement. Bounds the always-on tool surface. Option so the derived Config::default() and the serde default agree (both None = on) and saved configs don’t freeze the value. Per-server override: defer = false on the server entry. Read via Config::mcp_deferral_enabled.

providers: HashMap<String, UserProviderConfig>

User overrides + custom OpenAI-compatible providers. Keys are provider names; matching a built-in registry entry overrides its defaults, anything else defines a fully custom provider. Example:

[providers.groq]
api_key_env = "MY_GROQ_KEY"  # override default GROQ_API_KEY

[providers.my-vllm]
base_url = "http://192.168.1.42:8000/v1"
api_key_env = "VLLM_KEY"
compat = "openai-effort"

reasoning_per_model: HashMap<String, ReasoningLevel>

Per-model reasoning preferences keyed by full model ID (provider/name). Set when the user runs /reasoning <level> or Alt+T cycles while using a specific model — the new value sticks for that model until changed. Falls back to default_model.reasoning when no entry exists. Example:

[reasoning_per_model]
"<provider>/<model>" = "high"
"ollama/qwen3-coder:30b" = "low"

ollama_num_ctx_per_model: HashMap<String, u32>

Per-model Ollama num_ctx override set via /context <n>/max. Beats auto-fit; cleared by /context auto. Keyed by model id.

Example:

[ollama_num_ctx_per_model]
"ollama/ornith:9b" = 131072

model_aliases: HashMap<String, String>

Named model-id aliases that agents/plugins can request without hardcoding a concrete provider model. Values are full model IDs. (Distinct from [profiles.<name>], which are whole-config overlays selected with --profile.) Example:

[model_aliases]
fast = "ollama/qwen3-coder:14b"
large-context = "openai/<model>"
tool-strong = "anthropic/<model>"
vision = "gemini/gemini-2.5-pro"
cheap = "groq/llama-3.3-70b-versatile"

safety: SafetyConfig

Runtime safety policy. Defaults to Ask so mutations / shell / network actions require approval out of the box; users opt into Auto (LLM-vetted) or FullAccess deliberately.

memory: MemoryConfig

Durable semantic memory settings.

daemon: DaemonConfig

mermaidd background-daemon settings (task scheduler).

compaction: CompactionConfig

Context-compaction settings.

computer_use: ComputerUseConfig

Computer-use (desktop control) preferences.

exec: ExecConfig

Foreground execute_command behavior.

plan: PlanConfig

Plan-mode behavior (/plan, Alt+P).

agents: AgentsConfig

Subagent (agent tool) settings: drive timeout and user-defined agent types.

prompt: PromptConfig

Runtime-only prompt customizations supplied by CLI flags. These are deliberately skipped when saving config so one-off agent personas do not pollute the user’s persistent Mermaid settings.

active_profile: Option<String>

The --profile <name> overlay active this session, for doctor and startup notices. Runtime-only (skip): never persisted, and [profiles.*] itself is excised before deserialization ever sees it.

Implementations

impl Config

pub fn mcp_deferral_enabled(&self) -> bool

Effective value of Config::mcp_defer_tools: unset means ON.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.