Struct Config 

pub struct Config {
    pub defaults: Defaults,
    pub models: AgentModels,
    pub auto: AutoConfig,
    pub ollama: OllamaConfig,
    pub listen: ListenConfig,
}

Root configuration structure.

Fields

defaults: Defaults

Default settings

models: AgentModels

Per-agent model defaults

auto: AutoConfig

Auto-selection settings

ollama: OllamaConfig

Ollama-specific settings

listen: ListenConfig

Listen command settings

Implementations

impl Config

pub const VALID_PROVIDERS: &'static [&'static str]

Valid provider names (including “auto”).

pub const VALID_KEYS: &'static [&'static str]

All valid config keys for listing/discovery.

pub fn load(root: Option<&str>) -> Result<Self>

Load configuration from ~/.zag/projects/<id>/zag.toml.

The project ID is derived from the git repo root or explicit --root. Returns default config if file doesn’t exist.

pub fn save(&self, root: Option<&str>) -> Result<()>

Save configuration to ~/.zag/projects/<id>/zag.toml.

Creates the directory if it doesn’t exist.

pub fn init(root: Option<&str>) -> Result<bool>

Initialize config file with defaults if it doesn’t exist.

Returns true if a new config was created, false if it already existed.

pub fn global_base_dir() -> PathBuf

Get the global base directory (~/.zag).

pub fn sanitize_path(path: &str) -> String

Sanitize an absolute path into a directory name. Strips leading / and replaces / with -.

pub fn config_path(root: Option<&str>) -> PathBuf

Get the path to the config file.

pub fn agent_dir(root: Option<&str>) -> PathBuf

Get the project directory path (for sessions, etc.).

pub fn global_logs_dir() -> PathBuf

Get the global logs directory path.

pub fn get_model(&self, agent: &str) -> Option<&str>

Get the default model for a specific agent, if configured. Checks agent-specific model first, then falls back to defaults.model.

pub fn default_model(&self) -> Option<&str>

Get the global default model (without agent-specific override).

pub fn ollama_model(&self) -> &str

Get the ollama model name (default: “qwen3.5”).

pub fn ollama_size(&self) -> &str

Get the ollama default size (default: “9b”).

pub fn ollama_size_for<'a>(&'a self, size: &'a str) -> &'a str

Get the ollama size for a model size alias, with config override.

pub fn auto_approve(&self) -> bool

Check if auto-approve is enabled by default.

pub fn max_turns(&self) -> Option<u32>

Get the default max turns, if configured.

pub fn system_prompt(&self) -> Option<&str>

Get the default system prompt, if configured.

pub fn provider(&self) -> Option<&str>

Get the default provider, if configured.

pub fn auto_provider(&self) -> Option<&str>

Get the auto-selection provider, if configured.

pub fn auto_model(&self) -> Option<&str>

Get the auto-selection model, if configured.

pub fn listen_format(&self) -> Option<&str>

Get the listen output format, if configured.

pub fn listen_timestamp_format(&self) -> &str

Get the listen timestamp format (strftime-style, default: “%H:%M:%S”).

pub fn get_value(&self, key: &str) -> Option<String>

Get a config value by dot-notation key. Get a config value by dot-notation key.

pub fn set_value(&mut self, key: &str, value: &str) -> Result<()>

Set a config value by dot-notation key. Validates inputs.

pub fn unset_value(&mut self, key: &str) -> Result<()>

Unset a config value by dot-notation key (revert to default).

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.