Struct Config 

pub struct Config {

    pub default_provider: String,
    pub providers: BTreeMap<String, ProviderConfig>,
    pub agent: AgentConfig,
    pub tools: ToolsConfig,
    pub security: SecurityConfig,
    pub sandbox: SandboxConfig,
    pub mcp: Vec<McpServerConfig>,
    pub subagents: Vec<SubagentProfile>,
    pub search: Vec<SearchBackendConfig>,
    pub hooks: Vec<HookConfig>,
    pub outbox: OutboxConfig,
    pub work: WorkConfig,
    pub slack: SlackConfig,
    pub messages: MessagesConfig,
}

Fields

default_provider: String

Which entry in providers to use when --provider isn’t given.

providers: BTreeMap<String, ProviderConfig>

agent: AgentConfig

tools: ToolsConfig

security: SecurityConfig

sandbox: SandboxConfig

How shell is confined. See crate::sandbox.

mcp: Vec<McpServerConfig>

MCP servers to connect to at startup.

subagents: Vec<SubagentProfile>

Subagents the parent may delegate to, each exposed as one tool.

search: Vec<SearchBackendConfig>

Search backends, in preference order. The chain falls through on failure, which is what makes stacking two free tiers viable.

hooks: Vec<HookConfig>

User commands run at loop lifecycle points. See crate::hooks.

outbox: OutboxConfig

Outbound tools staged for user review instead of executed. See crate::outbox.

work: WorkConfig

Retention for ~/.mecha/work/. See crate::work.

slack: SlackConfig

Tunables for mecha slack. Global-file only; see SlackConfig.

messages: MessagesConfig

Inter-agent messages between mecha sessions on this machine. See crate::mailbox.

Implementations

impl Config

pub const PROJECT_FILE: &'static str = "mecha.toml"

pub fn global_path() -> Option<PathBuf>

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

Load defaults, then the global file, then the project file, then env.

pub fn load_global() -> Result<Self>

Defaults plus ~/.mecha/config.toml plus env — no project layer.

For runs that must not be configurable by whatever directory they happen to start in. A mecha.toml arrives with a cloned repository, and it can name MCP servers to spawn, hooks to execute and tools to enable; that is a reasonable bargain when a person is sitting there having just decided to work in that repository, and not one at all for a crate::trigger firing at 03:00 with nobody watching.

pub fn provider(&self, name: Option<&str>) -> Result<(String, &ProviderConfig)>

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

Write this config to path, creating parent directories.

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() -> Self

Returns the “default value” for a type.

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

where Config: Default,

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.