Struct AppConfig 

pub struct AppConfig {

    pub hotkey_listen: String,
    pub hotkey_new_session: String,
    pub grace_period_secs: u32,
    pub llm: LlmSettings,
    pub voice: VoiceSettings,
    pub mcp_servers: Vec<McpServerEntry>,
    pub mdh_pointers: HashMap<String, String>,
    pub ui: UiSettings,
    pub privacy: PrivacySettings,
    pub nats_url: String,
    pub developer: DeveloperSettings,
    pub notifications: NotificationSettings,
    pub web_search: WebSearchConfig,
    pub permissions: GlobalPermissionSettings,
    pub pipeline: PipelineSettings,
    pub prompt_enhancement: PromptEnhancementSettings,
    pub hooks: HooksSettings,
}

Application configuration persisted to a YAML file.

Only fields that differ from their defaults are written to disk. All other fields fall back to Default::default() at load time, keeping the YAML file minimal and human-readable.

Fields

hotkey_listen: String

Global hotkey to toggle the app or trigger recording.

hotkey_new_session: String

Global hotkey to open a new agent session window.

grace_period_secs: u32

Grace period in seconds for agent shutdown.

llm: LlmSettings

LLM configuration and provider selection.

voice: VoiceSettings

Voice/STT configuration.

mcp_servers: Vec<McpServerEntry>

MCP server configuration (full spec, Claude Code compatible).

mdh_pointers: HashMap<String, String>

MDH pointer mappings

ui: UiSettings

UI preferences (theme, accent)

privacy: PrivacySettings

Privacy and data-handling preferences shared by onboarding and settings.

nats_url: String

NATS URL for embedded MQ connectivity.

developer: DeveloperSettings

Developer and simulator settings

notifications: NotificationSettings

Notification settings for response completion and feedback

web_search: WebSearchConfig

Web search configuration

permissions: GlobalPermissionSettings

Global permission settings for tool execution

pipeline: PipelineSettings

Pipeline and context management settings

prompt_enhancement: PromptEnhancementSettings

Prompt enhancement settings

hooks: HooksSettings

Hooks configuration.

Implementations

impl AppConfig

pub fn data_dir() -> PathBuf

Returns the default directory for storing Gestura data On all platforms: ~/.gestura/

When GESTURA_HOME_DIR is set, Gestura resolves its data directory from that override instead of the OS home-directory lookup. This keeps spawned CLI processes and tests deterministic on platforms where standard home-dir resolution ignores HOME/USERPROFILE overrides.

pub fn default_path() -> PathBuf

Returns the default config path: ~/.gestura/config.yaml

pub fn legacy_json_path() -> PathBuf

Returns the legacy config path used by older versions: ~/.gestura/config.json

pub fn legacy_json_backup_path() -> PathBuf

Returns the legacy config backup path: ~/.gestura/config.json.backup

pub fn exists() -> bool

Check if a configuration file exists

pub fn is_first_run() -> bool

Check if this is the first run of the application

pub fn whisper_models_dir() -> PathBuf

Returns the default directory for Whisper models

pub fn default_whisper_model_path() -> PathBuf

Returns the default path for the recommended Whisper model

pub fn load_from_path(path: impl AsRef<Path>) -> AppConfig

Load configuration from disk at an explicit path.

If the file does not exist or cannot be read/parsed, this returns AppConfig::default.

pub async fn load_from_path_async(path: impl AsRef<Path>) -> AppConfig

Load configuration from disk at an explicit path (async).

If the file does not exist or cannot be read/parsed, this returns AppConfig::default.

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

Get a config value by dot-notation key (e.g., “llm.primary”)

pub fn list_keys() -> Vec<&'static str>

List all available config keys

pub fn set(&mut self, key: &str, value: &str) -> bool

Set a config value by its dot-notation key.

pub fn update_voice_provider(&mut self, provider: &str)

Update the selected voice provider.

pub fn update_whisper_model_filename(&mut self, model_filename: &str)

Update the configured Whisper model using a managed filename.

pub fn update_local_whisper_model_path(&mut self, model_path: impl Into<String>)

Point the local Whisper configuration at an explicit model path.

pub fn update_audio_device(&mut self, device_name: Option<String>)

Update the selected audio input device (None = system default).

pub fn update_llm_provider(&mut self, provider: &str) -> Result<(), AppError>

Update the primary LLM provider and ensure its config block exists.

pub fn update_provider_model( &mut self, provider: &str, model: &str, ) -> Result<(), AppError>

Update the model for a specific LLM provider.

pub fn update_ollama_config( &mut self, base_url: &str, model: &str, ) -> Result<(), AppError>

Update Ollama’s base URL and selected model.

pub fn apply_notification_settings_patch( &mut self, patch: NotificationSettingsPatch, )

Apply a partial notification-settings update.

pub fn update_default_enabled_tools(&mut self, patch: HashMap<String, bool>)

Merge default enabled-tool preferences into the global permission settings.

pub fn set_default_permission_level( &mut self, level: &str, ) -> Result<(), AppError>

Update the default permission level for new sessions.

pub fn set_theme_mode(&mut self, theme_mode: &str)

Update the selected UI theme mode.

pub fn apply_prompt_enhancement_settings_patch( &mut self, patch: PromptEnhancementSettingsPatch, )

Apply a partial prompt-enhancement settings update.

pub fn add_mcp_server_entry( &mut self, entry: McpServerEntry, ) -> Result<(), AppError>

Add an MCP server entry, rejecting duplicate names.

pub fn remove_mcp_server( &mut self, name: &str, ) -> Result<McpServerEntry, AppError>

Remove an MCP server entry by name.

pub fn set_mcp_server_enabled( &mut self, name: &str, enabled: bool, ) -> Result<(), AppError>

Enable or disable an MCP server by name.

pub fn apply_env_overrides(self) -> AppConfig

Apply environment variable overrides to the configuration

pub fn normalize_derived_defaults(&mut self)

Normalizes configuration fields whose defaults depend on sibling values.

pub fn find_mcp_server(&self, name: &str) -> Option<&McpServerEntry>

Find an MCP server entry by name (immutable).

pub fn find_mcp_server_mut(&mut self, name: &str) -> Option<&mut McpServerEntry>

Find an MCP server entry by name (mutable).

Trait Implementations

impl AppConfigSecurityExt for AppConfig

fn load() -> Self

Load configuration from disk, falling back to defaults if missing (sync version).

If ~/.gestura/config.yaml is missing but ~/.gestura/config.json exists, this will automatically migrate the JSON file to YAML.

This method also handles migration of secrets to the secure keystore.

async fn load_async() -> Self

Load configuration from disk asynchronously, falling back to defaults if missing.

This is the preferred method for GUI/Tauri commands to avoid blocking the UI thread.

fn save_to_path(&self, path: impl AsRef<Path>) -> Result<()>

Save configuration to disk at an explicit path.

This handles stripping secrets before writing to disk if security is enabled.

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

Save configuration to disk (sync version).

async fn save_async(&self) -> Result<()>

Save configuration to disk asynchronously.

async fn save_to_path_async(&self, path: impl AsRef<Path>) -> Result<()>

Save configuration to disk at an explicit path (async).

This is the async equivalent of AppConfig::save_to_path.

fn sanitize_secrets(&mut self)

Clear secrets from the struct (used before saving to disk)

fn api_key_keychain_status() -> Vec<(&'static str, bool)>

Check which API key providers have secrets stored in the OS keychain.

Returns a list of (provider_label, is_present) tuples for every known provider. This is intended for CLI/TUI display — no secret values are exposed.

When the security feature is disabled (or keychain access is disabled at runtime) every provider reports false.

fn has_plaintext_secrets(&self) -> bool

Returns true if the config struct currently contains any plaintext secrets that should not be persisted to disk.

fn hydrate_secrets_sync(&mut self) -> Result<()>

Load secrets from keystore into the struct (sync)

async fn hydrate_secrets(&mut self) -> Result<()>

Async version of hydrate secrets

fn migrate_secrets_sync(&self) -> Result<bool>

Move secrets from the struct (if present) to the keychain. Returns true if any secrets were migrated.

async fn migrate_secrets(&self) -> Result<bool>

Async version of migrate secrets

fn load_with_env() -> Self

Load configuration with environment variable overrides applied

This is the recommended way to load configuration as it respects the full precedence hierarchy: env vars > config file > defaults

async fn load_with_env_async() -> Self

Load configuration asynchronously with environment variable overrides

impl Clone for AppConfig

fn clone(&self) -> AppConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppConfig

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

Formats the value using the given formatter.

impl Default for AppConfig

fn default() -> AppConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AppConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<AppConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&AppConfig> for HotReloadableSettings

fn from(config: &AppConfig) -> HotReloadableSettings

Converts to this type from the input type.

impl PartialEq for AppConfig

fn eq(&self, other: &AppConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AppConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AppConfig

impl StructuralPartialEq for AppConfig