Struct Settings 

pub struct Settings {
    pub default_agent: Option<String>,
    pub default_model: Option<String>,
    pub default_permissions: Option<String>,
    pub default_timeout_secs: Option<u64>,
    pub log_level: Option<String>,
    pub agents: HashMap<String, AgentSettings>,
}

User settings loaded from ~/.config/harness/config.toml and optionally merged with a project-level .harnessrc.toml.

Fields

default_agent: Option<String>

Default agent to use if --agent is omitted.

default_model: Option<String>

Default model to use if --model is omitted.

default_permissions: Option<String>

Default permission mode (full-access or read-only).

default_timeout_secs: Option<u64>

Default timeout in seconds.

log_level: Option<String>

Log level for tracing output (e.g. “debug”, “info”, “warn”).

agents: HashMap<String, AgentSettings>

Per-agent configuration overrides.

Implementations

impl Settings

pub fn load() -> Self

Load settings from the default config file, optionally merged with a project-level .harnessrc.toml found by walking up from cwd.

pub fn load_with_project(cwd: Option<&Path>) -> Self

Load global settings, then merge project-level overrides from cwd.

pub fn load_from(path: Option<PathBuf>) -> Self

Load settings from a specific path.

pub fn load_project(start: &Path) -> Option<Self>

Walk up from start looking for .harnessrc.toml. Returns the parsed settings if found, None otherwise.

pub fn merge(&self, other: &Settings) -> Settings

Merge another settings into this one. other (project) wins for scalar fields; extra_args in agent settings are concatenated.

pub fn config_path() -> Option<PathBuf>

Default config file path: ~/.config/harness/config.toml.

pub fn template() -> &'static str

Generate a template config file as a TOML string.

pub fn resolve_default_agent(&self) -> Option<AgentKind>

Resolve the default agent from settings.

pub fn agent_settings(&self, kind: AgentKind) -> Option<&AgentSettings>

Get agent-specific settings.

pub fn agent_binary(&self, kind: AgentKind) -> Option<PathBuf>

Resolve the binary path for a given agent from settings.

pub fn agent_model(&self, kind: AgentKind) -> Option<String>

Resolve the model for a given agent from settings.

pub fn agent_extra_args(&self, kind: AgentKind) -> Vec<String>

Get agent-specific extra_args from settings.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Settings

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

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Settings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Settings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.