Struct Config 

pub struct Config {

    pub model: Option<String>,
    pub thinking: Option<ThinkingLevel>,
    pub max_tokens: Option<u32>,
    pub max_turns: Option<u32>,
    pub tools: Option<Vec<String>>,
    pub roles: HashMap<String, RoleDef>,
    pub hooks: Vec<HookDef>,
    pub context: ContextConfig,
    pub shell: ShellConfig,
    pub write: WriteConfig,
    pub guardrails: GuardrailConfig,
    pub mode: AgentMode,
    pub enabled_models: Option<Vec<String>>,
    pub theme: Option<String>,
    pub learning: LearningConfig,
    pub ui: UiConfig,
    pub web: WebConfig,
    pub mana: ManaConfig,
    pub lua: LuaConfig,
    pub secrets: SecretsConfig,
    pub personality: PersonalityConfig,
}

Top-level configuration.

Fields

model: Option<String>

Default model (alias or full ID).

thinking: Option<ThinkingLevel>

Default thinking level.

max_tokens: Option<u32>

Default max output tokens per response.

max_turns: Option<u32>

Maximum agent turns.

tools: Option<Vec<String>>

Active tool names (None = all).

roles: HashMap<String, RoleDef>

Named roles.

hooks: Vec<HookDef>

Hook definitions.

context: ContextConfig

Context management settings.

shell: ShellConfig

Shell backend settings.

write: WriteConfig

Write tool settings.

guardrails: GuardrailConfig

Engineering guardrails — profile-aware guidance and post-write checks.

mode: AgentMode

Agent mode — controls tool and mana action access.

enabled_models: Option<Vec<String>>

Enabled models for the model selector (None = show all). Entries can be canonical IDs or aliases (e.g. “sonnet”, “claude-sonnet-4-6”).

theme: Option<String>

Theme name (“default”, “light”, or custom).

learning: LearningConfig

Learning loop settings (memory, skill nudges).

ui: UiConfig

UI display settings.

web: WebConfig

Web tool settings.

mana: ManaConfig

Mana tool settings.

lua: LuaConfig

Shipped Lua extension runtime policy.

secrets: SecretsConfig

Secret injection policy for native command execution.

personality: PersonalityConfig

Personality settings, including identity sentence and saved profiles.

Implementations

impl Config

pub fn load(path: &Path) -> Result<Self>

Load config from a TOML file.

pub fn resolve( user_config_dir: &Path, project_dir: Option<&Path>, ) -> Result<Self>

Resolve the full config by merging: defaults < user < project < env < CLI.

pub fn user_config_dir() -> PathBuf

Default user config directory.

pub fn session_dir() -> PathBuf

Default session directory.

pub fn save(&self, path: &Path) -> Result<()>

Save config to a TOML file. Creates parent directories if needed.

pub fn user_config_path() -> PathBuf

Path to the user config.toml file.

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.