Struct Config 

pub struct Config {

    pub watchers: Vec<String>,
    pub auto_link: bool,
    pub auto_link_threshold: f64,
    pub commit_footer: bool,
    pub machine_id: Option<String>,
    pub machine_name: Option<String>,
    pub encryption_salt: Option<String>,
    pub use_keychain: bool,
    pub summary_provider: Option<String>,
    pub summary_api_key_anthropic: Option<String>,
    pub summary_api_key_openai: Option<String>,
    pub summary_api_key_openrouter: Option<String>,
    pub summary_model_anthropic: Option<String>,
    pub summary_model_openai: Option<String>,
    pub summary_model_openrouter: Option<String>,
    pub summary_auto: bool,
    pub summary_auto_threshold: usize,
    pub sync_global_remote: Option<String>,
}

Lore configuration settings.

Controls watcher behavior, auto-linking, and commit integration. Loaded from ~/.lore/config.yaml when available.

Fields

watchers: Vec<String>

List of enabled watcher names (e.g., “claude-code”, “cursor”).

auto_link: bool

Whether to automatically link sessions to commits.

auto_link_threshold: f64

Minimum confidence score (0.0-1.0) required for auto-linking.

commit_footer: bool

Whether to append session references to commit messages.

machine_id: Option<String>

Unique machine identifier (UUID) for sync deduplication.

Auto-generated on first access via get_or_create_machine_id().

machine_name: Option<String>

Human-readable machine name.

Defaults to hostname if not set. Can be customized by the user.

encryption_salt: Option<String>

Salt for encryption key derivation (base64-encoded).

Generated on first sync setup and stored for consistent key derivation. This is NOT secret - only the passphrase needs to be kept private.

use_keychain: bool

Whether to use the OS keychain for credential storage.

When false (default), the sync passphrase key is stored in a file under ~/.lore. When true, uses macOS Keychain, GNOME Keyring, or Windows Credential Manager. Note: Keychain may prompt for permission on first access.

summary_provider: Option<String>

LLM provider for summary generation (“anthropic”, “openai”, “openrouter”).

summary_api_key_anthropic: Option<String>

API key for Anthropic summary provider.

summary_api_key_openai: Option<String>

API key for OpenAI summary provider.

summary_api_key_openrouter: Option<String>

API key for OpenRouter summary provider.

summary_model_anthropic: Option<String>

Model override for Anthropic summary provider.

summary_model_openai: Option<String>

Model override for OpenAI summary provider.

summary_model_openrouter: Option<String>

Model override for OpenRouter summary provider.

summary_auto: bool

Whether to automatically generate summaries when sessions end.

summary_auto_threshold: usize

Minimum message count to trigger auto-summary generation.

sync_global_remote: Option<String>

Remote URL of the user’s private global personal store repository.

The global store (lore sync --global) is a managed git repo at ~/.lore/sync whose origin remote points at this URL. It holds the user’s cross-tool, cross-repo aggregate of encrypted sessions for personal multi-machine backup and search.

Implementations

impl Config

pub fn load() -> Result<Self>

Loads configuration from the default config file.

Returns default configuration if the file does not exist.

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

Saves configuration to the default config file.

Creates the ~/.lore directory if it does not exist.

pub fn load_from_path(path: &Path) -> Result<Self>

Loads configuration from a specific path.

Returns default configuration if the file does not exist.

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

Saves configuration to a specific path.

Creates parent directories if they do not exist.

pub fn get_or_create_machine_id(&mut self) -> Result<String>

Returns the machine UUID, generating and saving a new one if needed.

If no machine_id exists in config, generates a new UUIDv4 and saves it to the config file. This ensures a consistent machine identifier across sessions for sync deduplication.

pub fn get_machine_name(&self) -> String

Returns the machine name.

If a custom machine_name is set, returns that. Otherwise returns the system hostname. Returns “unknown” if hostname cannot be determined.

pub fn set_machine_name(&mut self, name: &str) -> Result<()>

Sets a custom machine name and saves the configuration.

The machine name is a human-readable identifier for this machine, displayed in session listings and useful for identifying which machine created a session.

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

Gets a configuration value by key.

Supported keys:

• watchers - comma-separated list of enabled watchers
• auto_link - “true” or “false”
• auto_link_threshold - float between 0.0 and 1.0
• commit_footer - “true” or “false”
• machine_id - the machine UUID (read-only, auto-generated)
• machine_name - human-readable machine name
• encryption_salt - salt for encryption key derivation (read-only)
• summary_provider - LLM provider for summaries
• summary_api_key_anthropic - Anthropic API key
• summary_api_key_openai - OpenAI API key
• summary_api_key_openrouter - OpenRouter API key
• summary_model_anthropic - Anthropic model override
• summary_model_openai - OpenAI model override
• summary_model_openrouter - OpenRouter model override
• summary_auto - “true” or “false”
• summary_auto_threshold - minimum messages for auto-summary
• sync_global_remote - remote URL of the global personal store repo

Returns None if the key is not recognized.

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

Sets a configuration value by key.

Supported keys:

• watchers - comma-separated list of enabled watchers
• auto_link - “true” or “false”
• auto_link_threshold - float between 0.0 and 1.0 (inclusive)
• commit_footer - “true” or “false”
• machine_name - human-readable machine name
• summary_provider - “anthropic”, “openai”, or “openrouter”
• summary_api_key_anthropic - Anthropic API key
• summary_api_key_openai - OpenAI API key
• summary_api_key_openrouter - OpenRouter API key
• summary_model_anthropic - Anthropic model override
• summary_model_openai - OpenAI model override
• summary_model_openrouter - OpenRouter model override
• summary_auto - “true” or “false”
• summary_auto_threshold - positive integer
• sync_global_remote - remote URL of the global personal store repo

Note: machine_id and encryption_salt cannot be set manually.

Returns an error if the key is not recognized or the value is invalid.

pub fn config_path() -> Result<PathBuf>

Returns the path to the configuration file.

The configuration file is located at ~/.lore/config.yaml.

pub fn valid_keys() -> &'static [&'static str]

Returns the list of valid configuration keys.

pub fn summary_api_key_for_provider(&self, provider: &str) -> Option<String>

Returns the API key for the given summary provider.

pub fn summary_model_for_provider(&self, provider: &str) -> Option<String>

Returns the model override for the given summary provider.

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 PartialEq for Config

fn eq(&self, other: &Config) -> 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 Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Config