Struct CommitConfig 

pub struct CommitConfig {

    pub api_base_url: String,
    pub api_mode: ApiMode,
    pub api_key: Option<String>,
    pub request_timeout_secs: u64,
    pub connect_timeout_secs: u64,
    pub disable_git_background_features: bool,
    pub compose_max_rounds: usize,
    pub summary_guideline: usize,
    pub summary_soft_limit: usize,
    pub summary_hard_limit: usize,
    pub max_retries: u32,
    pub initial_backoff_ms: u64,
    pub auto_fast_threshold_lines: usize,
    pub max_diff_length: usize,
    pub max_diff_tokens: usize,
    pub wide_change_threshold: f32,
    pub temperature: f32,
    pub analysis_model: String,
    pub summary_model: String,
    pub legacy_model: Option<String>,
    pub excluded_files: Vec<String>,
    pub low_priority_extensions: Vec<String>,
    pub max_detail_tokens: usize,
    pub analysis_prompt_variant: String,
    pub summary_prompt_variant: String,
    pub wide_change_abstract: bool,
    pub exclude_old_message: bool,
    pub gpg_sign: bool,
    pub signoff: bool,
    pub types: IndexMap<String, TypeConfig>,
    pub classifier_hint: String,
    pub categories: Vec<CategoryConfig>,
    pub changelog_enabled: bool,
    pub map_reduce_enabled: bool,
    pub map_reduce_threshold: usize,
    pub map_batch_token_budget: usize,
    pub cache_enabled: bool,
    pub cache_ttl_days: u32,
    pub cache_dir: Option<String>,
    pub analysis_prompt: String,
    pub summary_prompt: String,
}

Fields

api_base_url: String

api_mode: ApiMode

API mode for model endpoints (auto/chat-completions/anthropic-messages)

api_key: Option<String>

Optional API key for authentication (overridden by LLM_GIT_API_KEY env var)

request_timeout_secs: u64

HTTP request timeout in seconds

connect_timeout_secs: u64

HTTP connection timeout in seconds

disable_git_background_features: bool

Disable git background/index features that are slow for short-lived CLI subprocesses.

compose_max_rounds: usize

Maximum rounds for compose mode multi-commit generation

summary_guideline: usize

summary_soft_limit: usize

summary_hard_limit: usize

max_retries: u32

initial_backoff_ms: u64

auto_fast_threshold_lines: usize

max_diff_length: usize

Character ceiling used by smart truncation after a diff stays on the holistic path.

max_diff_tokens: usize

wide_change_threshold: f32

temperature: f32

analysis_model: String

summary_model: String

legacy_model: Option<String>

Legacy single-model config key. Parsed for backward compatibility and normalized into analysis_model, and into summary_model when the summary model was not set explicitly.

excluded_files: Vec<String>

low_priority_extensions: Vec<String>

max_detail_tokens: usize

Maximum token budget for commit message detail points (approx 4 chars/token)

analysis_prompt_variant: String

Prompt variant for analysis phase (e.g., “default”)

summary_prompt_variant: String

Prompt variant for summary phase (e.g., “default”)

wide_change_abstract: bool

Enable abstract summaries for wide changes (cross-cutting refactors)

exclude_old_message: bool

Exclude old commit message from context in commit mode (rewrite mode uses this)

gpg_sign: bool

GPG sign commits by default (can be overridden by –sign CLI flag)

signoff: bool

Add Signed-off-by trailer by default (can be overridden by –signoff CLI flag)

types: IndexMap<String, TypeConfig>

Commit types with descriptions for AI prompts (order = priority)

classifier_hint: String

Global hint for cross-type disambiguation

categories: Vec<CategoryConfig>

Changelog categories with matching rules (order = render order)

changelog_enabled: bool

Enable automatic changelog updates (default: true)

map_reduce_enabled: bool

Enable map-reduce for large diffs (default: true)

map_reduce_threshold: usize

Token threshold for routing to map-reduce before holistic smart truncation. Diffs below this stay in one analysis call and are bounded by max_diff_length instead (default: 5000 tokens).

map_batch_token_budget: usize

Token budget for each map-reduce map batch. Files are greedily packed up to this budget before an LLM call; oversized files run alone.

cache_enabled: bool

Enable the on-disk LLM response cache (default: true). Cache survives across runs so reruns reuse parsed call results when prompts match.

cache_ttl_days: u32

TTL in days for cached LLM responses (default: 14). Set to 0 to keep entries forever.

cache_dir: Option<String>

Override directory for the LLM response cache. Defaults to $XDG_CACHE_HOME/llm-git (or ~/.cache/llm-git).

analysis_prompt: String

Loaded analysis prompt (not in config file)

summary_prompt: String

Loaded summary prompt (not in config file)

Implementations

impl CommitConfig

pub fn resolved_api_mode(&self, _model_name: &str) -> ResolvedApiMode

pub fn load() -> Result<Self>

Load config from default location (~/.config/llm-git/config.toml) Falls back to Default if file doesn’t exist or can’t determine home directory Environment variables override config file values:

• LLM_GIT_API_URL overrides api_base_url
• LLM_GIT_API_KEY overrides api_key
• LLM_GIT_API_MODE overrides api_mode

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

Load config from specific file

pub fn default_config_path() -> Result<PathBuf>

Get default config path (platform-safe) Tries HOME (Unix/Linux/macOS) then USERPROFILE (Windows)

Trait Implementations

impl Clone for CommitConfig

fn clone(&self) -> CommitConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommitConfig

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

Formats the value using the given formatter.

impl Default for CommitConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CommitConfig

where CommitConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.