Struct Config 

pub struct Config {
    pub default_provider: String,
    pub providers: HashMap<String, ProviderConfig>,
    pub use_gitmoji: bool,
    pub instructions: String,
    pub instruction_preset: String,
    pub theme: String,
    pub subagent_timeout_secs: u64,
    pub temp_instructions: Option<String>,
    pub temp_preset: Option<String>,
    pub is_project_config: bool,
    pub gitmoji_override: Option<bool>,
}

Main configuration structure

Fields

default_provider: String

Default LLM provider

providers: HashMap<String, ProviderConfig>

Provider-specific configurations (keyed by provider name)

use_gitmoji: bool

Use gitmoji in commit messages

instructions: String

Custom instructions for all operations

instruction_preset: String

Instruction preset name

theme: String

Theme name (empty = default SilkCircuit Neon)

subagent_timeout_secs: u64

Timeout in seconds for parallel subagent tasks (default: 120)

temp_instructions: Option<String>

Runtime-only: temporary instructions override

temp_preset: Option<String>

Runtime-only: temporary preset override

is_project_config: bool

Runtime-only: flag if loaded from project config

gitmoji_override: Option<bool>

Runtime-only: whether gitmoji was explicitly set via CLI (None = use style detection)

Implementations

impl Config

pub fn load() -> Result<Self>

Load configuration (personal + project overlay)

Errors

Returns an error when personal or project configuration cannot be read or parsed.

pub fn load_project_config() -> Result<Self>

Load project-specific configuration

Errors

Returns an error when the project configuration file is missing or invalid.

pub fn get_project_config_path() -> Result<PathBuf>

Get path to project config file

Errors

Returns an error when the current repository root cannot be resolved.

pub fn merge_with_project_config(&mut self, project_config: Self)

Merge project config into this config (project takes precedence, but never API keys)

pub fn save(&self) -> Result<()>

Save configuration to personal config file

Errors

Returns an error when the personal configuration file cannot be serialized or written.

pub fn save_as_project_config(&self) -> Result<()>

Save as project-specific configuration (strips API keys)

Errors

Returns an error when the project configuration file cannot be serialized or written.

pub fn get_personal_config_path() -> Result<PathBuf>

Get path to personal config file

Errors

Returns an error when the config directory cannot be resolved or created.

pub fn check_environment(&self) -> Result<()>

Check environment prerequisites

Errors

Returns an error when the current working directory is not inside a Git repository.

pub fn set_temp_instructions(&mut self, instructions: Option<String>)

Set temporary instructions for this session

pub fn set_temp_preset(&mut self, preset: Option<String>)

Set temporary preset for this session

pub fn get_effective_preset_name(&self) -> &str

Get effective preset name (temp overrides saved)

pub fn get_effective_instructions(&self) -> String

Get effective instructions (combines preset + custom)

pub fn update( &mut self, provider: Option<String>, api_key: Option<String>, model: Option<String>, fast_model: Option<String>, additional_params: Option<HashMap<String, String>>, use_gitmoji: Option<bool>, instructions: Option<String>, token_limit: Option<usize>, ) -> Result<()>

Update configuration with new values

Errors

Returns an error when the provider is invalid or the provider config cannot be updated.

pub fn get_provider_config(&self, provider: &str) -> Option<&ProviderConfig>

Get the provider configuration for a specific provider

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

Get the current provider as Provider enum

pub fn validate(&self) -> Result<()>

Validate that the current provider is properly configured

Errors

Returns an error when the provider is invalid or no API key is configured.

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

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.